home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / indent-1.9.1-src.tgz / tar.out / fsf / indent / NEWS < prev    next >
Text File  |  1996-09-28  |  9KB  |  260 lines
  1. Release notes for GNU indent version 1.9.
  2.  
  3. * All reported bugs have been fixed.
  4.  
  5. * A new option "-lc" ("--comment-line-length") was added.
  6.  
  7. * Please read the section "BUG REPORTS" in the README file.
  8.  
  9. * Unless "interesting" bugs appear, this will be the last release of
  10.   indent version 1.  The next release planned is version 2, which will
  11.   (hopefully) integrate support for C++, and possibly Objective C.
  12.   Additionally, a couple more OS's may be supported.
  13.  
  14. * A volunteer is now working on the `review' program, which examines C
  15.   code and produces the options that GNU `indent' would use to produce
  16.   code in that style.
  17.  
  18. Release Notes for GNU indent version 1.8.
  19.  
  20. * VMS and MS-DOS are now supported.  Thanks to MEHRDAD@glum.dev.cf.ac.uk
  21.   and hnyman@lesti.hut.fi for their contributions.
  22.  
  23.   Please note that I have no way of testing this code, and with slight
  24.   modifications, have installed it "as is".
  25.  
  26.   Also, note that these systems do not use `configure'.  See the file
  27.   VMS-README for details of the VMS installation.  For the MS-DOS
  28.   version, it is expected that the compiler will recognize the define
  29.   __MSDOS__ as being set.
  30.  
  31. * C++ comments are now recognized.  More C++ support will be
  32.   forthcoming, possibly along with support for Objective C.
  33.  
  34. * Formatting can be disabled for sections of code by placing that code
  35.   between lines containing the comments /* *INDENT-OFF* */ and
  36.   /* *INDENT-ON* */ (this also works in C++ comments).  See the info
  37.   node "Disabling Formatting" for more info.
  38.  
  39. * The processing of comments has been changed.  See the info node on
  40.   "Comments" for a description.
  41.  
  42. * The default (i.e., GNU) behaviour of struct handling has been
  43.   slightly changed.
  44.  
  45. * All reported bugs have been fixed.
  46.  
  47.  
  48. Release Notes for GNU indent version 1.7.
  49.  
  50. * All reported bugs have been fixed, except some of those dealing with
  51.   comments.  I have completely rewritten the comment handling code in
  52.   indent, but since this produces rather different comment formats
  53.   (mostly, it makes several comment-related options actually work) I
  54.   am waiting for the next release of indent to install this.
  55.  
  56.   To see what the differences in the comment handling will be, compare
  57.   the file `comments.texinfo' to the section on comments in the info
  58.   node for indent.
  59.  
  60.   It is possible that I have lost some bug reports, as some of my mail
  61.   falls into a crack between two machines.  In the future, please be
  62.   sure to use the address "bug-gnu-utils@prep.ai.mit.edu".
  63.  
  64. * All errors and warnings are output on the standard error stream,
  65.   and conform to the GNU error message format.
  66.  
  67. * There is now more support for small (i.e., 16-bit) machines.
  68.  
  69. * There have been slight changes to the default behaviour, namely:
  70.  
  71.   - Column 1 comments are not formatted.
  72.  
  73.   - Preprocessor spaces are removed.
  74.  
  75. * When "-lps" is specified, whitespace preceding the '#' character is
  76.   left untouched, as well as following whitespace.
  77.  
  78. * When the tabsize is specified as 1 or 0 (e.g., "-ts 0"), spaces are
  79.   used instead of tabs.  There may be bugs in this behaviour, but they
  80.   should vanish with the new comment code.
  81.  
  82.  
  83. Release Notes for GNU indent version 1.6.
  84.  
  85. * All reported bugs have been fixed.
  86.  
  87. * The makefiles have been, hopefully, improved (see the file `README'
  88.   for installation procedure).  Essentially, it is sufficent to type
  89.   "make" to build indent.  `indent' is distributed with `configure'
  90.   just as other GNU software.  Thus, in conformance with the GNU
  91.   standards, "configure; make" should function properly and `indent'
  92.   should fit properly in a GNU software tree.  However, it is my hope
  93.   that for most users, "make" is all they will have to type.
  94.  
  95.  
  96. Release Notes for GNU indent version 1.5.
  97.  
  98. * All reported bugs (and some unreported ones) have been fixed.
  99.  
  100. * The default behaviour of `indent' has changed slightly to be more
  101.   compatible with Emacs' C-mode.  In particular, where version 1.4
  102.   produced code looking like:
  103.  
  104.   struct token_data
  105.   {
  106.     enum token_data_type type;
  107.     union
  108.     {
  109.       struct
  110.       {
  111.     char *text;
  112.       }
  113.     u_t;
  114.     }
  115.       u;
  116.   };
  117.  
  118.   version 1.5 now generates the following:
  119.  
  120.   struct token_data
  121.   {
  122.     enum token_data_type type;
  123.     union
  124.       {
  125.     struct
  126.       {
  127.         char *text;
  128.       }
  129.     u_t;
  130.       }
  131.     u;
  132.   };
  133.  
  134. * There is a new option, "-lps" ("--leave-preprocessor-space") which
  135.   causes `indent' to leave the space between the `#' and the command
  136.   on preprocessor lines.
  137.  
  138. * `indent' now understands spaces between options and their arguments.
  139.   It is thus now possible to type: "indent -ip 4 latex.c"
  140.   Such spaces are also understood in a profile.
  141.  
  142. * indent 1.5 uses a configuration script generated by autoconf.  It
  143.   examines the system to produce a host-dependent makefile. This has
  144.   changed little with regard to building indent;  typing "make" will
  145.   build `indent'.  See the file "README" for details of this process.
  146.  
  147. * The file "indent.1" is a man document for indent 1.4 sent to me by
  148.   vogel@c-17igp.wpafb.af.mil.  The GNU project uses texinfo for its
  149.   documentation system, so this man page will remain officially
  150.   unsupported.  However, I will continue to distribute it as long as it
  151.   appears reasonably up to date.
  152.  
  153. * Thanks to the folks that sent me patches.
  154.  
  155.  
  156. Release Notes for GNU indent version 1.4.
  157.  
  158. Essentially, this version fixes bugs in version 1.3.
  159.  
  160.  
  161.  
  162.  
  163.  
  164. Release Notes for GNU indent version 1.3.  For more details, read the
  165. manual.
  166.  
  167.  
  168. * All reported bugs have been fixed.
  169.  
  170.  
  171. * The manual has been upgraded somewhat.
  172.  
  173.  
  174. * Command line syntax has changed with regard to input and output files.
  175.   The command:
  176.  
  177.           indent *.c
  178.  
  179.   for each file iguana.c, will indent iguana.c into iguana.c, after
  180.   first making a backup copy.
  181.  
  182.           indent liver_oil.c -o gullet.c
  183.  
  184.           cat liver_oil.c | indent -o gullet.c
  185.  
  186.           indent liver_iol.c -st > gullet.c
  187.  
  188.   Each of the above will indent "liver_oil.c" into "gullet.c".  The
  189.   "-st" ("--standard-output") option can only be used when the
  190.   standard input, or only a single input file is specified.
  191.  
  192.   It is also possible to use the standard input by specifying the single
  193.   filename "-" on the command line.  In this case, no other files may
  194.   be specified.
  195.  
  196.  
  197. * indent now makes GNU-style backup files.
  198.  
  199.   This behaviour is controlled by two environment variables,
  200.   VERSION_CONTROL and SIMPLE_BACKUP_SUFFIX.
  201.  
  202.   VERSION_CONTROL determines what kinds of backups are made.  If it's
  203.   value is "numbered", then the first modification of some file
  204.   "eraserhead.c" will yield a backup file "eraserhead.c.~1~", the
  205.   second modification will yield "eraserhead.c.~2~", and so on.  It
  206.   does not matter if the version numbers are not a sequence;  the next
  207.   version will be one greater than the highest in that directory.
  208.  
  209.   If the value of VERSION_CONTROL is "numbered_existing", then such
  210.   numbered backups will be made if there are already numbered backup
  211.   versions of the file.  Otherwise, the backup name will be that of
  212.   the original file with "~" (tilde) appended.  E.g., "eraserhead.c~".
  213.  
  214.   If the value of VERSION_CONTROL is "simple", then the backup name
  215.   will be that of the original file with "~" appended, regardless of
  216.   whether or not there exist numbered versions in the directory.
  217.  
  218.   For simple backups, the value of SIMPLE_BACKUP_SUFFIX will be used
  219.   rather than "~" if it is set.
  220.  
  221.   If VERSION_CONTROL is unset, "numbered_existing" is assumed.  For
  222.   lisp lovers, "nil" is equivalent to "numbered_existing" and "t" is
  223.   equivalent to "numbered".
  224.  
  225.   Finally, if VERSION_CONTROL is "none" or "never", backups are not
  226.   made.  I suggest you avoid this behaviour.
  227.  
  228.   Note also that backup files are made in the directory of the source
  229.   file, not the current directory (where indent was invoked).
  230.  
  231.  
  232. * Only one indent profile is read.  indent searches first for a
  233.   profile in the current directory and reads that if found.
  234.   Otherwise, indent looks for a profil in the home directory.
  235.  
  236.  
  237. * "-nip" is now handled.  This is equivalent to "-ip0".
  238.  
  239.  
  240. * The long name for "-bs" has been changed from "--Bill_Shannon" to
  241. "--blank_after_sizeof".
  242.  
  243.  
  244. Release notes for GNU indent version 1.7
  245.  
  246. The default style of indent is now the GNU style.  The option "-gnu"
  247. is still recognized.  To obtain the original indent default, use
  248. "-orig".  It is possible to obtain the original defaults by compiling
  249. args.c with -DBERKELEY_DEFAULTS.
  250.  
  251. Long options are now handled, prefaced by either "+" or "--".
  252.  
  253. A new option, "-ts", allows specification of tab sizes.
  254.  
  255. All reported bugs have been fixed.
  256.  
  257. The man format of documentation is no longer included.  indent.texinfo
  258. is the official document, in accordance with GNU standards.
  259. Investigate the program "texi2roff" for generating a MAN page.
  260.