libgeda, gschem: Remove "major_changed_refdes" mechanism
[geda-gaf.git] / NEWS
bloba0dd58ea6781fa9f679722b60011208ae627dd18
1 ==============================================
2  'gschem and Friends' Electronic Design Suite
3 ==============================================
5 Copyright (C) 1998-2019 gEDA Developers
7 This file documents important user-visible changes in gEDA/gaf.  For
8 more information, please consult the `ChangeLog' file.
11 Notable changes in gEDA/gaf 1.10.0
12 ==================================
14 General changes
15 ---------------
17 * Added the library "xornstorage" and the Python package "gaf" as a
18   (currently quite minimal) way to access gEDA/gaf functionality from
19   outside of gschem.  These are on the long term intended to replace
20   libgeda, making the core gEDA/gaf functionality available as a
21   library to both gschem and other applications.
23 * Added command-line tool `xorn' for low-level schematic and symbol
24   file manipulation.
26 * Added experimental XML file format (currently only supported by
27   gnetlist and the `xorn' command line utility).
29 * Objects colors are limited to 21 (up to and including FREESTYLE4).
30   More recent colors added for GUI purposes can be set in colormaps
31   but aren't automatically added to the file format specification.
33 * The symbol directories "gnetman", "verilog", and "vhdl" are now
34   installed to the new location PREFIX/share/gEDA/extra-sym/.  This
35   allows adding the default library with "component-library-search".
37 * The directory to which gEDA programs write log transcripts can be
38   changed by setting the environment variable `GEDALOG' (the default
39   being ~/.gEDA/logs/).
41 * All tests now use the parallel test harness, speeding up `make
42   check' runs considerably when used with multiple jobs (-jN).
44 * Fixed bugs:
45   - lp-698501   gschem file preview function renders files twice
46   - lp-698524   gnetlist ignores duplicate inout-symbols
47   - lp-698768   No ordering requirement for attribute attach/detach
48   - lp-701637   gschem "Scheme Interaction" window
49   - lp-1266316  gschem exits on color value < 0
50   - lp-1367462  undo messes with the view even though undo panzoom is disabled
51   - lp-1492834  These docked dialogs should remember their size
52   - lp-1496899  gschem: dock window wishlist
53   - lp-1497659  gnetlist -v -g spice-sdb generates bad verbose netlist
54   - lp-1514209  gschem: multiattrib Value textview improvements
55   - lp-1532794  Build fails on missing colors.h
56   - lp-1576918  Memory and file handle leak in libgeda
57   - lp-1590757  partlist3 yields wrong netlist in some cases
58   - lp-1625474  xorn does not build on FreeBSD
59   - lp-1661961  "format not a string literal and no format arguments" warning
60   ...and a lot more which never made it to the bugtracker.
63 gschem changes
64 --------------
66 * Tool windows are now "dockable", i.e., they can be either used as
67   modal/non-modal dialogs or docked to the edges of the main window.
69 * The action mechanism used for menu items, tool buttons, and key
70   bindings has been redesigned, making several improvements possbile:
72   - Actions can now be used interchangeably in the main menu, toolbar,
73     context menu, and keymap.  They are defined in a single place
74     ("actions.c" for C actions and "builtins.scm" for Guile actions),
75     including metadata like name, icon, and tooltip.
77   - Menu items and tool buttons representing options have a little
78     check or radio box beside them indicating their current state.
80   - Menu items and tool buttons are greyed out while they can't be
81     used.
83   - Toolbar and context menu are customizable.
85   - Menu and toolbar definitions are simple Scheme variables, allowing
86     users to add actions to the menu without having to copy the menu
87     definition.  Actions are represented in Scheme code as applicable
88     SMOBs, allowing them to be called like procedures while retaining
89     the action information necessary for rendering the menus/toolbar.
91   - "Repeat Last Action" (usually bound to ".") uses the same logic as
92     the middle mouse button repeat action does, i.e., only actions
93     that "make sense" qualify for repeating.
95 * The menus, toolbar, and keymap have been revamped to more closely
96   resemble the "standards" for a desktop application.  Some actions
97   have been assigned more accessible or memorable keys.
99 * Added a command-line option "--control-fd=stdin|FD" which allows
100   remote-controlling gschem via a file descriptor.  This is intended
101   for project managers like Igor2's "genxproj".
103 * File operations have been consolidated: opening, saving, closing a
104   file and so on should now behave identical regardless of how the
105   operation was initiated.  Related improvements:
107   - When opening multiple files, the first one (instead of the last
108     one) is initially shown.
110   - The symversion= mismatch dialog is shown whenever a symversion=
111     mismatch is detected while opening a file, not just for files
112     specified on the command line.
114   - gschem now keeps track of which files are untitled, listing them
115     as "untitled page" instead of assigning them a temporary filename.
116     The Scheme procedure `page-filename' returns #f for untitled
117     pages.
119   - "Save all" used to produce spurious "untitled_1.sch" files.  This
120     was due to three issues working together, which have been fixed:
122     - When gschem is invoked without specifying filenames on the
123       command line, an untitled page is created.  This page wasn't
124       removed when opening files, staying invisibly in the background.
126     - "Save all" didn't check which files needed saving but just
127       unconditionally saved anything.
129     - "Save all" didn't behave like the interactive "Save", asking for
130       a filename for untitled pages, but just saved each page to its
131       internally stored filename.
133   - The file chooser dialog on "Open" and "Save As" is now always
134     opened in the current directory.
136   - When opening a file which is already open but has since been
137     changed on disk, the user is asked whether to reload the file.
139   - When the currently edited file has been modified on disk, a
140     notification is shown offering the user to reload the file.
142   - If the user enters a filename with an unusual extension while
143     saving, a confirmation dialog is shown.
145   - When trying to open a file or descend into a subschematic which
146     doesn't exist, gschem now offers to create a new file with that
147     name.
149 * Some improvements have been made to the multi-attribute editor:
151   - Editing a single attribute invokes the multi-attribute editor.
153   - Trying to edit an inherited attribute edits the attached attribute
154     with the same name if it exists, or promotes the attribute and
155     edits its value if it doesn't exist yet.
157   - Attributes are shown in the order in which they are listed in the
158     configuration (via "attribute-name").
160 * Attaching and detaching attributes now work as expected:
162   - "Attributes / Attach Attributes" used to depend on the order in
163     which objects were selected, taking the first selected object as
164     the base object to attach attributes to, regardless of its type.
165     Now, the selected objects are searched for a base object of
166     suitable type, and only if exactly one is found, the attributes
167     are attached to it.
169   - "Attributes / Detach Attributes" used to work on selected
170     components and nets, detaching all attributes from these objects.
171     It now works on the selected *attributes*, allowing the user to
172     selectively detach specific attributes while leaving the rest
173     attached.
175 * "Lock Component" used to lock components as well as non-component
176   objects, bringing the latter into an invalid state that would last
177   until the next "Undo" (or until the page was saved and loaded back
178   from file manually).
180   This has been fixed: "Lock Component" and "Unlock Component" now
181   only operate on components, changing the color of attached
182   attributes as they used to do with any selected text.
184 * The "Light Color Scheme" (V L) selected from the menu now has a
185   truly white background.  For compatibility, selecting the "lightbg"
186   colormap in gschemrc loads the old, light-gray color scheme; the new
187   color scheme can be selected as "whitebg".
189 * The library window has been made fit to be used as a dock window:
191   - When the dialog is resized to be taller than a certain aspect
192     ratio, it switches automatically to a stacked layout where the
193     preview and attribute panes are located below the symbol selector.
195   - While in stacked layout, the bottom panes can be expanded and
196     collapsed to give more room to the symbol selector.
198   - The window is automatically refreshed on library updates.
200 * Symbol editing has been improved:
202   - The page can now be scrolled to negative coordinates, making it
203     feasible to edit symbols without moving them away from the origin,
204     then translating them back.  This also allows to consciously
205     choose something that makes sense for the symbol as the location
206     of the origin.
208   - The coordinate origin is now indicated with slightly darker grid
209     lines.  (This can be enabled/disabled via "View / Show Origin".)
211   - The "Symbol Translate" action has been replaced with "Place
212     Origin" which lets the user select the position of the origin
213     interactively.
215 * Added support for back-annotation from pcb-rnd.
217 * Double-clicking a subschematic component enters the subschematic.
219 * Right-clicking in path mode works as expected.
221 * Pins are allowed to have zero length.
223 * "File / Revert" only asks for confirmation if the file has been
224   modified.
226 * The "repeat" function of the middle mouse button now evaluates
227   actions at the current mouse position.
229 * Mouse gestures work properly again.
231 * libstroke has been merged into gEDA/gaf.  This removes the
232   dependency on libstroke and makes mouse gestures always available.
234 * Added new mouse gestures for page navigation:
235   - swiping left goes to the previous, swiping right to the next page
236   - swiping right and then down enters a subschmatic
237   - swiping left and then down enters a symbol
238   - swiping up and sideways (in any combination) goes back to the
239     parent schematic
241 * The coordinate dialog has been replaced with an option to display
242   the coordinates in the status bar.
244 * Added further menu items:
246   - "Add / Last Component" (A C)
248   - "Object / Toggle Text Overbar" (T O)
250   - "View / Show Menubar" (V M)
251   - "View / Show Toolbar" (V T)
252   - "View / Show Scrollbars" (V S)
254   - "Tools / Select Locked Objects" (T L)
256 * Fixed various issues related to undo/redo:
258   - The menu items "Edit / Undo" and "Edit / Redo" now show the name
259     of the action that will be undone/redone.
261   - The current viewport used to be restored on undo/redo regardless
262     of the "undo-panzoom" setting (which prevents pan and zoom
263     operations from being recorded in the undo history).  This turned
264     out to confuse users, so if the setting is enabled, undo/redo now
265     doesn't change the viewport at all.
267   - The default mode ("undo-panzoom" disabled) now works correctly.
269   - After undoing the first action which changed a page, the page will
270     be considered "unchanged" again.
272   - Adding an attribute, changing the slot of a component, replacing
273     the contents of a picture, and selecting "Pan" from the menu used
274     not to be correctly un-doable.  This has been fixed.
276   - Selecting a picture to be added doesn't cause the page to be
277     treated as changed any more.
279   - "Object / Update Symbol" can't be undone with the current undo/
280     redo system, so it isn't listed as something that can be undone
281     any more.
283   - Several actions (attach/detach attribute, text actions, embed/
284     unembed, lock/unlock component, show/hide specific text) changed
285     the undo history even in the case that they didn't have any
286     effect.  This has been fixed.
288   - Several actions (attach/detach, embed/unembed) didn't update the
289     "changed" flag correctly; this has been fixed.
292 gnetlist changes
293 ----------------
295 * Refactored gnetlist:
297   - gnetlist is now part of the Python package "gaf" and uses the new
298     libraries instead of libgeda to work with gEDA files.
300   - Netlist backends can also be written in Python.
302   - When reading broken schematics and/or symbols, gnetlist doesn't
303     silently fail or produce bad output any more.  Conversely, this
304     means gnetlist has become more picky about input files: whenever
305     it occurs something that is likely to result in bad output, it
306     issues a warning or an error.
308   - In case there should be any problems with the refactored codebase,
309     the "old" gnetlist is still available as "gnetlist-legacy".
311 * If gnetlist is invoked with the `pcbfwd' backend or the new option
312   `--report-gui', errors and warnings are displayed in a GUI dialog
313   instead of printing them to stderr.
315 * There are new semantics for power and I/O port symbols:
317   - Power symbols can now use a netname=NET instead of a net=NET:1
318     attribute.  This allows using the attribute value as a visible
319     label, removing the need for power symbols for individual rails.
321   - I/O port symbols in subschematics can now use a portname=PORT
322     instead of a refdes=PORT attribute to distinguish them from
323     regular components.  This allows checking that unconnected port
324     symbols aren't silently included in the netlist as components.
326 * Hierarchical schematics can now use a simple form of parametrization
327   where the instantiating component contains an attribute of the form
328   `param=NAME=VALUE' and some attribute value in the subschematic
329   contains the pattern `$(NAME)', which will be replaced with `VALUE'.
330   This only works with regular attribute lookup from netlist backends
331   and won't affect special attributes like slot= or netname=, though.
333 * The netlisting options "hierarchy-traversal", "net-naming-priority",
334   "unnamed-netname", and "unnamed-busname" are once again configured
335   via gnetlistrc, making them consistent with the refdes=, net=, and
336   netname= mangling options.
338 * Duplicate I/O ports in subschematics and duplicate I/O pins in
339   subschematic symbols are now treated correctly.
341 * Added a netlist backend for pcb-rnd's tEDAx format.
343 * Added backends which dump the netlist in various generic formats
344   (dumpindent, dumpjson, dumplihata, dumptext, dumpxml).
347 Notable changes in gEDA/gaf 1.9.2.1p
348 ====================================
350 * The gEDA/gaf source tarball no longer includes libintl.  When
351   building gEDA/gaf with internationalisation support, a GNU
352   gettext-compatible libintl is now required.
354 * A new Scheme API function, `log!`, has been added to the `(geda
355   log)` module.  It allows Scheme code to emit log messages in the
356   same way that the tools' C code does.
359 Notable changes in gEDA/gaf 1.9.2
360 =================================
361 * Build system changes:
363   - Guile 2.0 or newer is now required.
365   - top-level control file allowing continuous integration using
366     Travis CI has been added.
368 * Nullor expansion has been fixed in the `spice' and `spice-sdb'
369   backends.
371   - Element name prefix "E_" has been substituted for "E-" to prevent
372     errors output by some simulators (e.g. ngspice).
374   - A default gain value has been added in the nullor expansion code.
376 * Two obsolete scripts verilog2vhdl.sh and script.sed have been
377   removed.
379 * Undocumented and ambiguous feature of the `spice-sdb' backend for
380   gnetlist consisting in the possibility of using the "value="
381   attribute instead of "file=" only for include blocks and only in
382   embedding mode has been removed.
384 * The following scripts and programs have been moved from the `utils'
385   directory to a new `contrib' directory and are no longer installed
386   by default:
388          smash_megafile          olib
389          gmk_sym                 convert_sym
390          sarlacc_schem           sarlacc_sym
391          pads_backannotate       sw2asc
392          gnet_hier_verilog.sh
394 * `gpstoimage' has been removed from the distribution; equivalent
395   functionality is provided by the `gaf' command.
397 * `convert_sym.awk' has been removed from the distribution; equivalent
398   functionality is provided by the `convert_sym' command.
400 * gnetlist now supports output of netlists to the standard output.
402 * New Scheme procedures and hooks have been added.  Please see the
403   "geda-scheme" info manual for more details.
405   - `set-component-with-transform!' is a modified version of
406     `set-component!', which applies all the specified transformations
407     to a component and immediately updates it.
409   - `auto-refdes-reset!' resets components' refdeses
411   - `copy-objects-hook' is called whenever an object is copied, it can
412     be used, for example, to reset component's refdes on copy.
414 * The following gschem configuration items have been added:
416   - `third-button-cancel' cancels draw actions by the third mouse
417     button in mousepan mode.
419   - `grid-mode' sets default grid mode.
421 * Fixes/updates to the *BSD, Mac OS X, and MinGW builds.
423 * Changes in the gschem UI event state machine:
425   - New drawing modes apply immediately.
427   - Indication of an action being in progress has been added.
429   - Mirror action can now be used during an object placement.
431   - Show/hide text function is now enabled during other actions.
433   - RMB panning is now enabled during placing or drawing.
435 * Some gschem dialog have been merged, made non-modal, and placed in
436   sidebar:
438   - Color, line, fill and pin type dialogs have been merged into one
439     non-modal object properties dialog with widgets applying values
440     immediately.
442   - Text properties dialog.
444   - Options to control the magnetic net mode and the net rubber band
445     mode as well as grid mode and grid snap mode have been merged into
446     one options dialog.
448 * The following dialogs/windows have been converted into an info bar
449   and are now placed in bottom notebook:
451   - Log (status) window.
453   - Find text dialog.
455 * The following dialogs are now popup & docked the same way as the
456   execute script dialog:
458   - Show and hide text dialogs.
460   - Translate dialog.
462 * Other gschem GUI changes:
464   - Hotkeys and menu items to show/hide the sidebar and status window
465     have been added.
467   - Swatch for fill types has been added.
469   - Slot edit dialog now displays number of slots.
471   - Library folder structure in gschem is now displayed as tree.
473   - Indication of page change has been added in gschem main window's
474     title.
476 * Improved find text functionality:
478   - When searching for text, gschem now descends all files specified
479     in the comma separated list of the source attribute.
481   - There is now a widget that lists all occurences of the text
482     objects that contain the search string.
484   - The find text operation does not switch the current schematic in
485     the view or interfere with the most recent page up.
487   - The find text operation also searches all open pages instead of
488     the current one.
490   - The behavior of the find text operation works with multiple
491     toplevel windows open while running concurrent find text
492     operations.
494   - The find text operation can now use either a substring, pattern,
495     or regex. The pattern style uses * and ?. The regex uses glib,
496     which adheres to perl compatible regular expressions.
498 * Several symbols have been fixed/improved.
500 * gschemdoc has been enhanced to search in the user documentation
501   directory.
503 * Several translations have been added/updated.
505 * Man pages for gsymcheck and gschlas have been updated.
507 * Switches --help and -h have been added for most of gEDA utilities.
509 * Fixed the following bugs:
511   -  900122: Gschem crashes on ctrl-x.
512   - 1258834: spice-sdb crashes on non-existing files.
513   - 1463178: Gsch2pcb crashes when using `m4-pcbdir' option.
514   - 1478760: Gschem segmentation fault during find text.
515   - Gschem crashes on pressing the third mouse button.
516   - SVG output bug in `gaf export'.
517   - Several other bugs.
520 Notable changes in gEDA/gaf 1.9.1
521 =================================
523 * Unbalanced overbar markers are now rendered correctly.
525 * Most tools now no longer set the GEDADATA or GEDADATARC environment
526   variables (they still obey them though).
528 * `gschem' now provides a path drawing tool, accessed using <A H> or
529   the "Add Path" menu item.
531   - Add a cusp node by left-clicking.
533   - Add a Bezier curve node by left-dragging from the node point to
534     the control point.
536   - End the path by clicking on the same node point twice, or clicking
537     on the start node to close the path.
539 * On desktops that reparent menu bars (e.g. Ubuntu Unity) it is once
540   again possible to paste the clipboard using the menus.
542 * A number of `gschem' editing behaviour changes were made:
544   - Double-clicking on an entry in the "In Use" tab of the component
545     selector now behaves the same way as double-clicking in the
546     "Libraries" tab.
548   - When new attributes are attached to a net, they are placed at a 50
549     unit offset.
551   - The text color is now used as the default color for `pinlabel='
552     attributes.
554   - Pin attributes are no longer automatically replaced when rotating
555     or mirroring pins.
557   - It is possible to edit a text object even when other non-text
558     objects are selected.
560   - Control grips are now always drawn at the same on-screen size.
562 * The multi-attribute editor dialog in `gschem' has been extended to
563   support more cases:
565   - It now supports editing attributes of multiple selected
566     objects. These are aggregated into the dialog's attribute list.
568     Multiple attributes with the same name attached to any given
569     object are still shown in separate rows, but identically named
570     attributes from multiple selected objects will share a row. If a
571     row has differing values between objects, its value shows the text
572     "<various>" in a muted colour.
574   - Where an attribute is present in some, but not all selected
575     objects its name in the list is shown in red. A new popup menu
576     option allows copying such attributes to all selected objects.
578   - If no complex, placeholder, pin, net or bus objects are selected,
579     the dialog now falls back to editing any selected attribute text.
581     This allows editing of unattached or floating attributes in
582     symbols, or any attributes seleccted independantly of their owning
583     object. In this fallback mode, all attributes with the same name
584     shown in separate rows, and the "add attribute" functionality is
585     disabled.
587 * `gschem' has new icons for many editing commands.
589 * Several bugs were fixed in `gnetlist':
591   - Invalid attributes are ignored.
593   - Correct detection of graphical symbols.
595   - Components with no `refdes=' attribute are reported.
597   - Crash fixes for `drc' and `switcap' backends.
599 * `gaf export' now accepts a `--scale' option.
601 * The `--size', `--margins' and `--align' options to `gaf export' can
602   now accept their multiple arguments separated with a space ` ', a
603   colon `:' or a semicolon `;'.
605 * `gaf config' now handles the `-p' option properly.
607 * `gnetlist', `gsymcheck' and `gaf' now output internationalised
608   messages.
610 * New Scheme procedures were added. Please see the "geda-scheme" info
611   manual for more details.
613   - The (gschem action) module contains procedures for working with
614     user editing actions (i.e. commands accessed via the menus or
615     keybindings).
617   - Two new hooks were added: `bind-keys-hook' is called whenever
618     keymap bindings are changed; `action-property-hook' is called when
619     action properties are changed.
622 Notable changes in gEDA/gaf 1.9.0
623 =================================
625 * A new schematic renderer library, `libgedacairo' has been added, and
626   all tools have been updated to use it.  Related changes:
628   - The following configuration functions have been removed:
630          output-capstyle         paper-sizes
631          output-color            postscript-prolog
632          output-orientation      print-command
633          output-type             setpagedevice-orientation
634          paper-size              setpagedevice-pagesize
636   - The following `gschem' configuration items have been added:
638          print-paper             print-color
639          print-orientation
641   - `gschem' now generates PDF files rather than PostScript or EPS
642     files.
644   - `gschem' now uses a standard GTK print dialog (with printer
645     selection, print preview, etc.)
647 * A new `gaf' command-line utility has been added.  It provides a
648   number of subcommands:
650   - `gaf export' can be used to convert schematic files to PNG, SVG,
651     PDF, PS and EPS, with detailed control of paper size and margins.
652     It supports multi-page PDF and PS output.
654   - `gaf config' can be used to manipulate the project, user, and
655     system configuration stores (see below).
657   - `gaf shell' provides a Scheme REPL for batch manipulation of
658     schematic and symbol files.
660 * New project, user and system configuration stores have been added,
661   using a format similar to .desktop files.  They can be manipulated
662   using the `gaf config' tool.  Configuration parameters for most
663   tools will be converted to use this mechanism in future releases.
665 * The changes to highlighting of dangling net ends in gEDA/gaf 1.8.0
666   have been reverted.  All dangling ends are once again flagged with a
667   brightly-coloured square.
669 * When editing a component with the `gschem' multi-attribute editor,
670   the dialog will now show the symbol name in its title.
672 * When using "Down Schematic" command in `gschem', an error message
673   will now be displayed if the subcircuit schematic cannot be loaded.
675 * Printing now uses a light background color map by default.
677 * Objects can now have the line end "cap style" adjusted in `gschem'.
679 * `gnetlist' now accepts the `-i' and `-g' command-line arguments
680   together.  If you specify both `-i' and `-g', `gnetlist' will enter
681   the Scheme REPL after loading the requested backend but before
682   executing it.
684 * `gattrib' now has translations for the user interface and various
685   messages.
687 Notable changes in gEDA/gaf 1.8.2
688 =================================
690 Bugfix release.
692 * [994361] Fixed a libgeda crash bug involving nets inside symbols.
694 * [1226246] Fixed a gnetlist data corruption bug when using refdes
695   containing the string "POWER".
697 * Updates to build system to allow compilation from git on systems
698   with Automake >= 1.13.0.
700 Notable changes in gEDA/gaf 1.8.1
701 =================================
703 Bugfix release with correct dynamic version information for libgeda.
705 Notable changes in gEDA/gaf 1.8.0
706 =================================
708 * `gschem' and `gnetlist' have updated and rewritten user guides.
710 * All tools now give more informative error messages if they are
711   unable to load schematic or symbol files due to syntax errors.
713 * All tools now correctly handle schematic and symbol files with `\r',
714   `\n', or `\r\n` line endings, or a mixture.
716 * Unconnected pin ends and net ends are now all drawn with the same
717   box marker in `gschem' and printed output.
719 * Net segments with at least two connections (including indirect
720   connections via `netname=' attributes) are now drawn with arrowheads
721   rather than box markers on dangling ends in `gschem' and printed
722   output.
724 Notable changes in gEDA/gaf 1.7.2
725 =================================
727 * `geda-gaf' now requires GTK+ 2.16.0 or later.
729 * A greatly expanded Scheme API has been added to gEDA/gaf for use by
730   extension authors.  See the `geda-scheme' Info manual for more
731   details.  Existing extensions may need to be modified to load the
732   `(geda deprecated)' or `(gschem deprecated)' modules.
734 * The `component-library-search' function for `gafrc' files now skips
735   directories without symbols, and searches for libraries recursively.
737 * `gschem' keybinding improvements:
739   - Keybindings are now unaffected by Caps Lock.
741   - Keystrokes are displayed using the same characters as on keycaps
742     (e.g. `:' instead of `colon').
744   - Keystrokes may use extended modifiers (Super, Hyper and Meta).
746   - Key bindings can be modified in any rc file or interactively using
747     the `global-set-key' function.  See notes in `system-gschemrc' for
748     examples.
750 * `gschem' now displays help files and component documentation on all
751   platforms, including Windows.  The `locate' tool is no longer used
752   to search for component documentation files.
754 * The `schdiff' tool for generating visual diffs of schematics and
755   symbols has been added.  It can be used with most version control
756   systems.  See `man schdiff' for more details.
758 * The `bom' and `bom2' backends to `gnetlist' now give error messages
759   if no attribute file can be found.  The `-O attrib_file=FILE' and
760   `-O attribs=ATTRIB,ATTRIB...' options have also been added.
762 * A new `ewnet' backend has been added to `gnetlist'.  This outputs
763   netlists for use with the National Instruments ULTIboard layout
764   tool.
766 * The `verilog' backend to `gnetlist' now supports concatenated net
767   naming like "{a,b,c[3:0]}".
769 * `gsch2pcb' no longer supports the `m4_command' parameter in project
770   files.
772 * The `--m4-pcbdir' and `--m4-file' arguments to `gsch2pcb' now work
773   again.
775 * `gsymfix.pl' has been renamed to `gsymfix'.
777 * Man pages are now available for all programs installed as part of
778   gEDA/gaf.
780 * The undocumented programs `gnet_hier_verilog', `gsymupdate', `gschupdate'
781   and `sch2eaglepos.sh' are no longer installed to ${prefix}/bin.
783 Notable changes in gEDA/gaf 1.7.1
784 =================================
786 * gEDA is now compatible with Guile 2.0.
788 * gEDA/gaf applications no longer complain when trying to load an rc
789   file twice, or when an rc file doesn't exist.
791 * `gschem' allows objects to be moved by dragging without having to
792   select them first.
794 * `gschem' now supports keybindings with more than one modifier key,
795   and "Deselect" is bound to <Control Shift A> by default.
797 * `gnetlist' correctly handles multiple renames of the same net.  This
798   resolves some long-standing bugs with multipage schematics.
800 * The `spice-sdb' backend for `gnetlist' now has built-in support for
801   `SUBCKT_NMOS' and `SUBCKT_PMOS' devices.
803 * A new `makedepend' backend has been added to `gnetlist'.  It
804   generates Makefile code for SPICE simulation dependencies.
806 * Visibility of embedded component attributes are now preserved by
807   `gattrib'.
809 * `gsch2pcb' correctly handles footprint names with hyphens (`-').
811 * `gsch2pcb' project files support quoting and escaping in
812   `schematics' entries.
814 * Considerable enhancements to Unicode support when printing
815   schematics or exporting PostScript.
817 Notable changes in gEDA/gaf 1.7.0
818 =================================
820 * All gEDA/gaf applications now handle configuration files much more
821   strictly, and provide much more useful feedback when an error
822   occurs.
824 * Several changes to `gschem' command-line options:
826   - The `-t' option is no longer supported.
828   - Several command-line options now support a long-form alternative.
830   - The `-s' option can now be used to run multiple Scheme scripts
831     during `gschem' startup.
833   - A new `-c' option is available, which runs a Scheme expression
834     during `gschem' startup.
836   - A new `-L' option is available, which adds a directory to the
837     Scheme load path.
839   - A new `-V' or `--version' option is available, which displays
840     version information.
842 * `gschem' now provides a "Select All" function, which is bound to
843   <Control a> by default, along with a corresponding "Deselect"
844   function.
846 * In the `gschem' "Add component" dialog, filtering the component
847   library will expand matching libraries.  If the filter is cancelled,
848   all libraries are collapsed.  Components can now be selected by
849   double-clicking on them in the component list.
851 * The `gschem' "Edit Text Properties" dialog now has an easier to use
852   "Alignment" menu.
854 * Printed text size now better matches on-screen text size in
855   `gschem'.
857 * Special characters, including commas, are now escaped or quoted
858   appropriately in `gattrib' CSV output.
860 * Several changes to `gnetlist' command-line options:
862   - Four command-line options specific to the `spice-sdb' backend have
863     been removed.  They can be replaced with `-O <option>' according
864     to the following table:
866         -e, --embedd              -O embedd_mode
867         -I, --include             -O include_mode
868         -n, --nomunge             -O nomunge_mode
869         -s, --sort                -O sort_mode
871   - The list of available backends is now obtained using a new
872     `--list-backends' option.  `-g help' no longer outputs a list of
873     backends.
875   - A new `-L' option is available, which adds a directory to the
876     Scheme load path.
878   - A new `-V' or `--version' option is available, which displays
879     version information.
881   - When run with invalid command-line arguments, `gnetlist' now exits
882     with non-zero exit status.
884 * Several `gnetlist' backends have now been fixed so that it should no
885   longer be necessary to set an expanded Guile stack in gEDA's config
886   files.
888 * The `spice-sdb' backend for `gnetlist' now supports probes
889   (`TESTPOINT' devices).
891 * The undocumented `mk_verilog_syms' program is no longer installed.
892   The symbols it creates are still installed to
893   `${prefix}/share/gEDA/sym/verilog'.
895 Notable changes in gEDA/gaf 1.6.2
896 =================================
898  * PNG export from `gschem' will now be cropped correctly.
900  * The `partlist' backends for `gnetlist' now handle hierarchical
901    refdes correctly.
903  * On Windows, `gschem' and `gattrib' will no longer launch with a
904    command window visible.
906  * `gnetlist-arg' is no longer valid in `gsch2pcb' project files.
908 Several other bugs were fixed, including a major crash bug in
909 gnetlist.
911 Notable changes in gEDA/gaf 1.6.1
912 =================================
914 * Added accelerator mnemonics for root menus in gschem
916 * Lots of updated and new language translations in libgeda, gschem, and
917   gattrib.  (Courtesy of language translators and Launchpad)
919 * Updated the shipped documentation from the official gEDA wiki
921 * Fixed the following bugs:
923   - 2876373: Fix rendering with zoomed out dashed lines
924   - 2901183: Fix for some manpage issues
925   - 2904715: Don't update page connectivity from o_place_rotate()
926   - 2949232: Fix slot editing routines to not edit inherited attributes
927   - Cherry picked some other bug fixes from master that should be in
928     this release
930 Notable changes in gEDA/gaf 1.6.0
931 =================================
933 * Fixed the GtkItemEntry code inside of gattrib code so that it builds
934   using gtk+ > 2.16.x.
936 * In gschem, rubberband pin to pin connections by adding nets.
938 * Cleanup of the slot handling code in libgeda.
940 * Fixes/updates to the MinGW port.
942 * Updated the shipped documentation from the online wiki.
944 Notable changes in gEDA/gaf 1.5.3/1.5.4
945 =======================================
947 * NOTE: gEDA/gaf 1.5.3 was released with some critical bugs, so
948         it was withdrawn before it was widely distributed.
950 * Text rendering using native system fonts:
952   - The various programs in gEDA/gaf no longer uses its own built-in
953     line font.
955   - Native system fonts are used for rendering, giving support for a
956     wider range of symbols, and better looking schematics.
958 * Always use PostScript fonts in gschem's PostScript output.  The
959   "output-text", "text-output" and "output-vector-threshold" config
960   functions have been removed.
962 * Image rendering in 'gschem' uses cairo instead of GDK.
964 * Numerous build system changes:
966   - gEDA/gaf is now distributed as a single source archive, called
967     gEDA-<version>.tar.gz.
969   - GTK+ 2.10 or newer and Guile 1.8 or newer are now required.
971   - `intltool' is no longer required.
973   - Documentation is now installed to ${docdir} (usually
974     ${prefix}/share/doc/gEDA).
976 * The attribute edit dialog in `gschem' now has completion of most
977   common attribute names.
979 * The multi-attribute edit dialog in `gschem' now shows unpromoted
980   symbol attributes.
982 * Menu items in `gschem' now have icons and properly aligned key
983   bindings. They also support accelerator keys.
985 * The `gschem2pcb' and `PCBboard' netlist backends have been removed.
986   It is recommended to use `gsch2pcb' instead.
988 * Check for and reject non-footprint PCB files in 'gsch2pcb'.
990 * Removed unimplemented "File->Open" feature in 'gattrib'.
992 * Added --disable-gattrib command line flag to ./configure to disable the
993   building of 'gattrib'.  This is useful if you are building against
994   gtk+ 2.17.x which breaks 'gattrib'.
996 * 'gnetlist' does not recommend drc2 every time it runs.  The drc2
997   backend is only useful in certain circumstances.
999 * Assign shortcuts "vd" and "vl" for changing between color schemes
1000   in 'gschem'.
1002 * Fix problem with attached net attribute not being honored in 'gnetlist'.
1004 * Focus the "save" button in the close confirmation dialog in 'gattrib' and
1005   'gschem'.
1007 * Accept empty attributes in the src file in 'tragesym'.
1009 * Cleaned up the slot dialog box in 'gschem'.
1011 * Changed the grip size rendering in 'gschem' to be reasonably sized when
1012   zoomed in a lot.
1014 * Introduction of a new attribute searching API in 'libgeda' and 'gschem'.
1016 * Improvements and cleanup to the 'gnetlist' and 'gsymcheck' test suites.
1018 * Fixed the following bugs:
1020   - 1758673: Combine source tarballs
1021   - 2058707: gschem, gattrib: Dangerous button focus in "Save changes"
1022              dialog at quit
1023   - 2430369: gschem: Deselect invisible attribs with their parent object.
1024   - 2449060: Graphic state left inconsistent cancelling from net mode
1025   - 2460301: libgeda: Make o_complex_promote_attribs() respect keep_invisible
1026              and libgeda: Make o_complex_copy() actually copy.
1027   - 2455061: Gnetlist output changed, and tests fail with recent GLib
1028   - 2655088: autogen.sh: Make sure to exit if autopoint fails.
1029   - 2823703: gnet-pcbpins.scm: Quote pins names if they contain comma
1030              or close parenthesis.
1031   - 2823755: gnetlist: Fix DEBUG builds.
1032   - 2836109: build-sys: Add check for groff html driver.
1034 * Spanish translation were updated.
1036 * Lots of code, infrastructure, and doxygen documentation cleanup and
1037   refactoring.
1039 Notable changes in gEDA/gaf 1.5.2
1040 =================================
1042 * `gschem' now uses Cairo for all rendering.  This allows for
1043   everything to be rendered anti-aliased.
1045 * `gschem' now uses a mesh grid instead of dots by default.
1047 * Net junction cues in `gschem' are drawn smaller now.
1049 * Copy and paste now works between different `gschem' instances (using
1050   the X selection).
1052 * Recent files are no longer opened in a new `gschem' window.
1054 * Major, *backwards-incompatible* changes to color handling in
1055   `libgeda' and `gschem'.
1057   - All colors are specified using hexadecimal `#RRGGBB' or
1058     `#RRGGBBAA' syntax.
1060   - The print and display color maps are now separate.
1062   - A new Scheme syntax is used to inspect and modify color maps.
1064   - If you wish to use a light background in `gschem', add the line:
1066       (load (build-path geda-rc-path "gschem-colormap-lightbg"))
1068     to your personal or project gschemrc file.
1070 * Attributes of embedded objects are now shown in the right color.
1072 * Bus pins are now supported by `gschem' and `libgeda', but are *not*
1073   properly supported by the netlister.  The pin type can be modified
1074   by selecting a pin, then right-clicking it and selecting `Edit pin
1075   type...'.
1077 * All of the symbols were modified to use overbar markup tags ("like
1078   \_this\_") instead of separate lines.
1080 * Log files are now saved to $HOME/.gEDA/logs rather than being
1081   dropped in the current directory.
1083 Notable changes in gEDA/gaf 1.5.1
1084 =================================
1086 * GTK+ version 2.8.x or later is now required.
1088 * The selection behaviour in `gschem' was changed.
1090   - Lines, unfilled boxes, unfilled circles, arcs, pins, nets, and
1091     buses must be selected by clicking on the drawn path itself.
1093   - Filled boxes, circles, text, and components, may be selected by
1094     clicking anywhere in the bounding box.
1096   - The default mouse click distance required to select an element was
1097     increased to 10 pixels.
1099   - Double-clicking on a net segment selects all connected net
1100     segments.
1102 * The percentage step in or out while zooming the display in `gschem'
1103   is now configurable with the `zoom-gain' gschemrc parameter.  The
1104   default value is 20%.
1106 * The size of steps when panning with the mouse wheel or with a
1107   trackpad in `gschem' is now adjustable with the `scrollpan-steps'
1108   gschemrc parameter.  The default setting scrolls in steps of 1/8 of
1109   a screen.
1111 * A number of improvements were made to the `gschem' component
1112   selection dialog.
1114   - The dialog now shows a table of top-level attributes in the
1115     selected symbol.
1117   - It is now possible to expand/collapse a library by clicking
1118     anywhere on its row.
1120 * Changes to fill- and line-styles in `gschem' can now be undone.
1122 * Arcs can now be adjusted in `gschem' using an arc angle dialog.  It
1123   can be accessed by selecting an arc and selecting Edit->Edit.
1125 * It is now possible to rotate objects while placing them in `gschem'.
1127 * Support for arbitrary filled and unfilled paths, using a subset of
1128   the SVG path syntax.  For more information, please see the file
1129   format specification.
1130   <http://wiki.geda-project.org/geda:file_format_spec>
1132   - `gschem' does not yet provide a GUI for creating or editing path
1133     elements.  However, it does support rendering them.  They can also
1134     be printed.
1136   - Some of the symbols in the component library were updated to use
1137     paths.
1139 * A Scheme evaluation prompt was added to `gschem'.  It can be
1140   accessed by typing `:'.
1142 * Improved algorithm for drawing hatched fills both on screen and in
1143   PostScript output.
1145 * Color selection dialogs and menus in `gschem' now show the actual
1146   color as well as the description.  Color names are now translatable.
1148 * `gattrib' now prompts to save changes.
1150 * All of the unimplemented menu items and pages in `gattrib' were
1151   removed.
1153 * The `always-promote-attributes' gafrc parameter now takes a list of
1154   strings as an argument.  The space-delimited string syntax is
1155   deprecated.
1157 * Some optimisations were made to the `gnetlist' connection traversal
1158   algorithm to speed up netlisting large designs.
1160 * A new netlist backend was added to support Liquid PCB.
1161   <http://www.liquidpcb.org/>
1163 * The `bom2' netlist backend now generates a `qty' column.
1165 * Several improvements and fixes were made to the `systemc' backend.
1167 * The `--gnetlist-arg' option to gsch2pcb can now be used to pass
1168   extra `gnetlist' arguments.
1170 * `gsch2pcb' now emits files with the latest `pcb' file format.
1172 * The `gxyrs' pick-and-place tool was added.
1174 Notable changes in gEDA/gaf 1.5.0
1175 =================================
1177 * Magnetic net mode in `gschem'. Magnetic mode lets you draw nets and
1178   automatically connect to valid end points (such as pins and other
1179   nets).  The `magnetic-net-mode' gschemrc parameter can be used to
1180   enable/disable this feature.
1182 * Rotating a component while moving it in `gschem' now rotates around
1183   the current mouse location.
1185 * The `verilog' and `vhdl' backends now work again.
1187 * Embedded components can now be mirrored.
1189 * The `pads' netlist backend now uses CRLF line endings.
1191 Older versions
1192 ==============
1194 Release notes for older versions of gEDA/gaf are available on the gEDA
1195 website.  <http://www.gpleda.org/news/index.html>
1198    Local Variables:
1199    mode: text
1200    End: