schdiff: Use a here document for usage.
[geda-gaf/whiteaudio.git] / NEWS
blob1efffb55630d5c355c6d8e6bf068fe6969725d9a
1 ==============================================
2  'gschem and Friends' Electronic Design Suite
3 ==============================================
5 Copyright (C) 1998-2011 gEDA Developers
7 This file documents important user-visible changes in gEDA/gaf.  For
8 more information, please consult the `ChangeLog' file.
10 Notable changes in gEDA/gaf 1.7.2
11 =================================
13 * `geda-gaf' now requires GTK+ 2.16.0 or later.
15 * A greatly expanded Scheme API has been added to gEDA/gaf for use by
16   extension authors.  See the `geda-scheme' Info manual for more
17   details.  Existing extensions may need to be modified to load the
18   `(geda deprecated)' or `(gschem deprecated)' modules.
20 * `gschem' keybinding improvements:
22   - Keybindings are now unaffected by Caps Lock.
24   - Keystrokes are displayed using the same characters as on keycaps
25     (e.g. `:' instead of `colon').
27   - Keystrokes may use extended modifiers (Super, Hyper and Meta).
29   - Key bindings can be modified in any rc file or interactively using
30     the `global-set-key' function.  See notes in `system-gschemrc' for
31     examples.
33 * `gschem' now displays help files and component documentation on all
34   platforms, including Windows.  The `locate' tool is no longer used
35   to search for component documentation files.
37 * The `schdiff' tool for generating visual diffs of schematics and
38   symbols has been added.  It can be used with most version control
39   systems.  See `man schdiff' for more details.
41 * The `bom' and `bom2' backends to `gnetlist' now give error messages
42   if no attribute file can be found.  The `-O attrib_file=FILE' and
43   `-O attribs=ATTRIB,ATTRIB...' options have also been added.
45 * A new `ewnet' backend has been added to `gnetlist'.  This outputs
46   netlists for use with the National Instruments ULTIboard layout
47   tool.
49 * The `verilog' backend to `gnetlist' now supports concatenated net
50   naming like "{a,b,c[3:0]}".
52 * `gsch2pcb' no longer supports the `m4_command' parameter in project
53   files.
55 * The `--m4-pcbdir' and `--m4-file' arguments to `gsch2pcb' now work
56   again.
58 Notable changes in gEDA/gaf 1.7.1
59 =================================
61 * gEDA is now compatible with Guile 2.0.
63 * gEDA/gaf applications no longer complain when trying to load an rc
64   file twice, or when an rc file doesn't exist.
66 * `gschem' allows objects to be moved by dragging without having to
67   select them first.
69 * `gschem' now supports keybindings with more than one modifier key,
70   and "Deselect" is bound to <Control Shift A> by default.
72 * `gnetlist' correctly handles multiple renames of the same net.  This
73   resolves some long-standing bugs with multipage schematics.
75 * The `spice-sdb' backend for `gnetlist' now has built-in support for
76   `SUBCKT_NMOS' and `SUBCKT_PMOS' devices.
78 * A new `makedepend' backend has been added to `gnetlist'.  It
79   generates Makefile code for SPICE simulation dependencies.
81 * Visibility of embedded component attributes are now preserved by
82   `gattrib'.
84 * `gsch2pcb' correctly handles footprint names with hyphens (`-').
86 * `gsch2pcb' project files support quoting and escaping in
87   `schematics' entries.
89 * Considerable enhancements to Unicode support when printing
90   schematics or exporting PostScript.
92 Notable changes in gEDA/gaf 1.7.0
93 =================================
95 * All gEDA/gaf applications now handle configuration files much more
96   strictly, and provide much more useful feedback when an error
97   occurs.
99 * Several changes to `gschem' command-line options:
101   - The `-t' option is no longer supported.
103   - Several command-line options now support a long-form alternative.
105   - The `-s' option can now be used to run multiple Scheme scripts
106     during `gschem' startup.
108   - A new `-c' option is available, which runs a Scheme expression
109     during `gschem' startup.
111   - A new `-L' option is available, which adds a directory to the
112     Scheme load path.
114   - A new `-V' or `--version' option is available, which displays
115     version information.
117 * `gschem' now provides a "Select All" function, which is bound to
118   <Control a> by default, along with a corresponding "Deselect"
119   function.
121 * In the `gschem' "Add component" dialog, filtering the component
122   library will expand matching libraries.  If the filter is cancelled,
123   all libraries are collapsed.  Components can now be selected by
124   double-clicking on them in the component list.
126 * The `gschem' "Edit Text Properties" dialog now has an easier to use
127   "Alignment" menu.
129 * Printed text size now better matches on-screen text size in
130   `gschem'.
132 * Special characters, including commas, are now escaped or quoted
133   appropriately in `gattrib' CSV output.
135 * Several changes to `gnetlist' command-line options:
137   - Four command-line options specific to the `spice-sdb' backend have
138     been removed.  They can be replaced with `-O <option>' according
139     to the following table:
141         -e, --embedd              -O embedd_mode
142         -I, --include             -O include_mode
143         -n, --nomunge             -O nomunge_mode
144         -s, --sort                -O sort_mode
146   - The list of available backends is now obtained using a new
147     `--list-backends' option.  `-g help' no longer outputs a list of
148     backends.
150   - A new `-L' option is available, which adds a directory to the
151     Scheme load path.
153   - A new `-V' or `--version' option is available, which displays
154     version information.
156   - When run with invalid command-line arguments, `gnetlist' now exits
157     with non-zero exit status.
159 * Several `gnetlist' backends have now been fixed so that it should no
160   longer be necessary to set an expanded Guile stack in gEDA's config
161   files.
163 * The `spice-sdb' backend for `gnetlist' now supports probes
164   (`TESTPOINT' devices).
166 * The undocumented `mk_verilog_syms' program is no longer installed.
167   The symbols it creates are still installed to
168   `${prefix}/share/gEDA/sym/verilog'.
170 Notable changes in gEDA/gaf 1.6.2
171 =================================
173  * PNG export from `gschem' will now be cropped correctly.
175  * The `partlist' backends for `gnetlist' now handle hierarchical
176    refdes correctly.
178  * On Windows, `gschem' and `gattrib' will no longer launch with a
179    command window visible.
181  * `gnetlist-arg' is no longer valid in `gsch2pcb' project files.
183 Several other bugs were fixed, including a major crash bug in
184 gnetlist.
186 Notable changes in gEDA/gaf 1.6.1
187 =================================
189 * Added accelerator mnemonics for root menus in gschem
191 * Lots of updated and new language translations in libgeda, gschem, and
192   gattrib.  (Courtesy of language translators and Launchpad) 
194 * Updated the shipped documentation from the official gEDA wiki
196 * Fixed the following bugs:
198   - 2876373: Fix rendering with zoomed out dashed lines
199   - 2901183: Fix for some manpage issues
200   - 2904715: Don't update page connectivity from o_place_rotate()
201   - 2949232: Fix slot editing routines to not edit inherited attributes 
202   - Cherry picked some other bug fixes from master that should be in
203     this release
205 Notable changes in gEDA/gaf 1.6.0
206 =================================
208 * Fixed the GtkItemEntry code inside of gattrib code so that it builds
209   using gtk+ > 2.16.x.
211 * In gschem, rubberband pin to pin connections by adding nets.
213 * Cleanup of the slot handling code in libgeda.
215 * Fixes/updates to the MinGW port.
217 * Updated the shipped documentation from the online wiki.
219 Notable changes in gEDA/gaf 1.5.3/1.5.4
220 =======================================
222 * NOTE: gEDA/gaf 1.5.3 was released with some critical bugs, so
223         it was withdrawn before it was widely distributed.
225 * Text rendering using native system fonts:
227   - The various programs in gEDA/gaf no longer uses its own built-in
228     line font.
230   - Native system fonts are used for rendering, giving support for a
231     wider range of symbols, and better looking schematics.
233 * Always use PostScript fonts in gschem's PostScript output.  The
234   "output-text", "text-output" and "output-vector-threshold" config
235   functions have been removed.
237 * Image rendering in 'gschem' uses cairo instead of GDK.
239 * Numerous build system changes:
241   - gEDA/gaf is now distributed as a single source archive, called
242     gEDA-<version>.tar.gz.
244   - GTK+ 2.10 or newer and Guile 1.8 or newer are now required.
246   - `intltool' is no longer required.
248   - Documentation is now installed to ${docdir} (usually
249     ${prefix}/share/doc/gEDA).
251 * The attribute edit dialog in `gschem' now has completion of most
252   common attribute names.
254 * The multi-attribute edit dialog in `gschem' now shows unpromoted
255   symbol attributes.
257 * Menu items in `gschem' now have icons and properly aligned key
258   bindings. They also support accelerator keys.
260 * The `gschem2pcb' and `PCBboard' netlist backends have been removed.
261   It is recommended to use `gsch2pcb' instead.
263 * Check for and reject non-footprint PCB files in 'gsch2pcb'.
265 * Removed unimplemented "File->Open" feature in 'gattrib'.
267 * Added --disable-gattrib command line flag to ./configure to disable the
268   building of 'gattrib'.  This is useful if you are building against
269   gtk+ 2.17.x which breaks 'gattrib'.
271 * 'gnetlist' does not recommend drc2 every time it runs.  The drc2
272   backend is only useful in certain circumstances.
274 * Assign shortcuts "vd" and "vl" for changing between color schemes
275   in 'gschem'.
277 * Fix problem with attached net attribute not being honored in 'gnetlist'.
279 * Focus the "save" button in the close confirmation dialog in 'gattrib' and
280   'gschem'.
282 * Accept empty attributes in the src file in 'tragesym'.
284 * Cleaned up the slot dialog box in 'gschem'.
286 * Changed the grip size rendering in 'gschem' to be reasonably sized when
287   zoomed in a lot.
289 * Introduction of a new attribute searching API in 'libgeda' and 'gschem'.
291 * Improvements and cleanup to the 'gnetlist' and 'gsymcheck' test suites.
293 * Fixed the following bugs:
295   - 1758673: Combine source tarballs
296   - 2058707: gschem, gattrib: Dangerous button focus in "Save changes"
297              dialog at quit
298   - 2430369: gschem: Deselect invisible attribs with their parent object.
299   - 2449060: Graphic state left inconsistent cancelling from net mode
300   - 2460301: libgeda: Make o_complex_promote_attribs() respect keep_invisible
301              and libgeda: Make o_complex_copy() actually copy.
302   - 2455061: Gnetlist output changed, and tests fail with recent GLib
303   - 2655088: autogen.sh: Make sure to exit if autopoint fails.
304   - 2823703: gnet-pcbpins.scm: Quote pins names if they contain comma
305              or close parenthesis.
306   - 2823755: gnetlist: Fix DEBUG builds.
307   - 2836109: build-sys: Add check for groff html driver.
309 * Spanish translation were updated.
311 * Lots of code, infrastructure, and doxygen documentation cleanup and
312   refactoring.
314 Notable changes in gEDA/gaf 1.5.2
315 =================================
317 * `gschem' now uses Cairo for all rendering.  This allows for
318   everything to be rendered anti-aliased.
320 * `gschem' now uses a mesh grid instead of dots by default.
322 * Net junction cues in `gschem' are drawn smaller now.
324 * Copy and paste now works between different `gschem' instances (using
325   the X selection).
327 * Recent files are no longer opened in a new `gschem' window.
329 * Major, *backwards-incompatible* changes to color handling in
330   `libgeda' and `gschem'.
332   - All colors are specified using hexadecimal `#RRGGBB' or
333     `#RRGGBBAA' syntax.
335   - The print and display color maps are now separate.
337   - A new Scheme syntax is used to inspect and modify color maps.
339   - If you wish to use a light background in `gschem', add the line:
341       (load (build-path geda-rc-path "gschem-colormap-lightbg"))
343     to your personal or project gschemrc file.
345 * Attributes of embedded objects are now shown in the right color.
347 * Bus pins are now supported by `gschem' and `libgeda', but are *not*
348   properly supported by the netlister.  The pin type can be modified
349   by selecting a pin, then right-clicking it and selecting `Edit pin
350   type...'.
352 * All of the symbols were modified to use overbar markup tags ("like
353   \_this\_") instead of separate lines.
355 * Log files are now saved to $HOME/.gEDA/logs rather than being
356   dropped in the current directory.
358 Notable changes in gEDA/gaf 1.5.1
359 =================================
361 * GTK+ version 2.8.x or later is now required.
363 * The selection behaviour in `gschem' was changed. 
365   - Lines, unfilled boxes, unfilled circles, arcs, pins, nets, and
366     buses must be selected by clicking on the drawn path itself.
368   - Filled boxes, circles, text, and components, may be selected by
369     clicking anywhere in the bounding box.
371   - The default mouse click distance required to select an element was
372     increased to 10 pixels.
374   - Double-clicking on a net segment selects all connected net
375     segments.
377 * The percentage step in or out while zooming the display in `gschem'
378   is now configurable with the `zoom-gain' gschemrc parameter.  The
379   default value is 20%.
381 * The size of steps when panning with the mouse wheel or with a
382   trackpad in `gschem' is now adjustable with the `scrollpan-steps'
383   gschemrc parameter.  The default setting scrolls in steps of 1/8 of
384   a screen.
386 * A number of improvements were made to the `gschem' component
387   selection dialog.
389   - The dialog now shows a table of top-level attributes in the
390     selected symbol.
392   - It is now possible to expand/collapse a library by clicking
393     anywhere on its row.
395 * Changes to fill- and line-styles in `gschem' can now be undone.
397 * Arcs can now be adjusted in `gschem' using an arc angle dialog.  It
398   can be accessed by selecting an arc and selecting Edit->Edit.
400 * It is now possible to rotate objects while placing them in `gschem'.
402 * Support for arbitrary filled and unfilled paths, using a subset of
403   the SVG path syntax.  For more information, please see the file
404   format specification.
405   <http://geda.seul.org/wiki/geda:file_format_spec>
407   - `gschem' does not yet provide a GUI for creating or editing path
408     elements.  However, it does support rendering them.  They can also
409     be printed.
411   - Some of the symbols in the component library were updated to use
412     paths.
414 * A Scheme evaluation prompt was added to `gschem'.  It can be
415   accessed by typing `:'.
417 * Improved algorithm for drawing hatched fills both on screen and in
418   PostScript output.
420 * Color selection dialogs and menus in `gschem' now show the actual
421   color as well as the description.  Color names are now translatable.
423 * `gattrib' now prompts to save changes.
425 * All of the unimplemented menu items and pages in `gattrib' were
426   removed.
428 * The `always-promote-attributes' gafrc parameter now takes a list of
429   strings as an argument.  The space-delimited string syntax is
430   deprecated.
432 * Some optimisations were made to the `gnetlist' connection traversal
433   algorithm to speed up netlisting large designs.
435 * A new netlist backend was added to support Liquid PCB.
436   <http://www.liquidpcb.org/>
438 * The `bom2' netlist backend now generates a `qty' column.
440 * Several improvements and fixes were made to the `systemc' backend.
442 * The `--gnetlist-arg' option to gsch2pcb can now be used to pass
443   extra `gnetlist' arguments.
445 * `gsch2pcb' now emits files with the latest `pcb' file format.
447 * The `gxyrs' pick-and-place tool was added.
449 Notable changes in gEDA/gaf 1.5.0
450 =================================
452 * Magnetic net mode in `gschem'. Magnetic mode lets you draw nets and
453   automatically connect to valid end points (such as pins and other
454   nets).  The `magnetic-net-mode' gschemrc parameter can be used to
455   enable/disable this feature.
457 * Rotating a component while moving it in `gschem' now rotates around
458   the current mouse location.
460 * The `verilog' and `vhdl' backends now work again.
462 * Embedded components can now be mirrored.
464 * The `pads' netlist backend now uses CRLF line endings.
466 Older versions
467 ==============
469 Release notes for older versions of gEDA/gaf are available on the gEDA
470 website.  <http://www.gpleda.org/news/index.html>
473    Local Variables:
474    mode: text
475    End: