diff NEWS @ 26843:c32c825ee021

doc: Use Markdown syntax for NEWS file and add sections. * NEWS: Use Markdown syntax and add sections. See https://lists.gnu.org/archive/html/octave-maintainers/2019-03/msg00016.html for a discussion.
author Kai T. Ohlhus <k.ohlhus@gmail.com>
date Tue, 05 Mar 2019 10:02:42 +0100
parents 10653e92e205
children 0adb232f93b9
line wrap: on
line diff
--- a/NEWS	Tue Mar 05 09:33:22 2019 +0100
+++ b/NEWS	Tue Mar 05 10:02:42 2019 +0100
@@ -1,91 +1,104 @@
 Summary of important user-visible changes for version 6 (yyyy-mm-dd):
 ----------------------------------------------------------------------
 
- ** The interpreter now supports handles to nested functions which was a
-    long-standing incompatibility with Matlab.
-
- ** The graphics backend has seen many small improvements.
+### General improvements
 
-    * Graphic primitives now accept a color property value of "none"
-      which is useful when a particular primitive needs to be hidden
-      (for example, the Y-axis of an axes object with "ycolor" = "none")
-      without hiding the entire primitive ("visibility" = "off").
-
-    * "LineWidth" and "MarkerSize" properties are now measured in
-      points, *not* pixels.  This change was made for Matlab
-      compatibility.  Compared to previous versions of Octave, some
-      lines and markers will appear 4/3 larger.
+- The `edit` function option `"editinplace"` now defaults to `true`.
+  Files will no longer be copied to the user's HOME directory for
+  editing and then copied back to their original location.
 
-    * The appearance of patterned lines (LineStyle = ":"|"--"|"-.") has
-      been improved for small widths (LineWidth < 1.5 pixels) which is a
-      common scenario.
+#### Graphics backend
 
- ** Printing to EPS files now uses a tight bounding box ("-tight"
-    argument to print) by default.  This makes more sense for EPS
-    files which are normally embedded within other documents, and is
-    Matlab compatible.  If necessary use the "-loose" option to
-    reproduce figures as they appeared in previous versions of Octave.
-
- ** The edit function option "editinplace" now defaults to true.  Files
-    will no longer be copied to the user's HOME directory for editing
-    and then copied back to their original location.
-
- ** New functions added in Octave 6:
+- Graphic primitives now accept a color property value of `"none"`
+  which is useful when a particular primitive needs to be hidden
+  (for example, the Y-axis of an axes object with `"ycolor" = "none"`)
+  without hiding the entire primitive `"visibility" = "off"`.
 
-      lightangle
-      verLessThan
-
- ** Deprecated functions.
-
-    The following functions have been deprecated in Octave 6 and will
-    be removed from Octave 8 (or whatever version is the second major
-    release after 6):
-
-      Function               | Replacement
-      -----------------------|------------------
-      output_max_field_width | output_precision
-
- ** The following functions were deprecated in Octave 4.4 and have been
-    removed from Octave 6.
+- The appearance of patterned lines `"LineStyle" = ":"|"--"|"-."` has
+  been improved for small widths (`"LineWidth"` less than 1.5 pixels)
+  which is a common scenario.
 
-      Function             | Replacement
-      ---------------------|------------------
-      chop                 | sprintf for visual results
-      desktop              | isguirunning
-      tmpnam               | tempname
-      toascii              | double
-      java2mat             | __java2mat__
+- Printing to EPS files now uses a tight bounding box (`"-tight"`
+  argument to print) by default.  This makes more sense for EPS
+  files which are normally embedded within other documents, and is
+  Matlab compatible.  If necessary use the `"-loose"` option to
+  reproduce figures as they appeared in previous versions of Octave.
+
 
- ** Deprecated graphics properties.
+### Matlab compatibility
+
+- The interpreter now supports handles to nested functions.
 
-    The following properties or allowed corresponding values have been
-    deprecated in Octave 6 and will be removed from Octave 8 (or
-    whatever version is the second major release after 6):
-
-      Object               | Property                | Value
-      ---------------------|-------------------------|-------------------
+- The graphics properties `"LineWidth"` and `"MarkerSize"` are now
+  measured in points, *not* pixels.  Compared to previous versions
+  of Octave, some lines and markers will appear 4/3 larger.
 
 
- ** The following properties or allowed corresponding values were
-    deprecated in Octave 4.4 and have been removed from Octave 6:
+### Deprecated functions and properties
+
+The following functions and properties have been deprecated in Octave 6
+and will be removed from Octave 8 (or whatever version is the second major
+release after 6):
+
+- Functions
+
+  Function               | Replacement
+  -----------------------|------------------
+                         |
+
+- Properties
+
+  Object           | Property      | Value
+  -----------------|---------------|------------
+                   |               |
+
+
+### Removed functions and properties
+
+The following functions and properties were deprecated in Octave 4.4
+and have been removed from Octave 6.
+
+- Functions
+
+  Function             | Replacement
+  ---------------------|------------------
+  `chop`               | `sprintf` for visual results
+  `desktop`            | `isguirunning`
+  `tmpnam`             | `tempname`
+  `toascii`            | `double`
+  `java2mat`           | `__java2mat__`
 
-      Object               | Property                | Value
-      ---------------------|-------------------------|-------------------
-      figure               | doublebuffer            |
-                           | mincolormap             |
-                           | wvisual                 |
-                           | wvisualmode             |
-                           | xdisplay                |
-                           | xvisual                 |
-                           | xvisualmode             |
-      axes                 | drawmode                |
-      annotation           | edgecolor ("rectangle") |
-      text                 | fontweight              | "demi" and "light"
-      uicontrol            | fontweight              | "demi" and "light"
-      uipanel              | fontweight              | "demi" and "light"
-      uibuttongroup        | fontweight              | "demi" and "light"
-      uitable              | fontweight              | "demi" and "light"
+- Properties
 
----------------------------------------------------------
+  Object               | Property                  | Value
+  ---------------------|---------------------------|-----------------------
+  `figure`             | `doublebuffer`            |
+                       | `mincolormap`             |
+                       | `wvisual`                 |
+                       | `wvisualmode`             |
+                       | `xdisplay`                |
+                       | `xvisual`                 |
+                       | `xvisualmode`             |
+  `axes`               | `drawmode`                |
+  `annotation`         | `edgecolor ("rectangle")` |
+  `text`               | `fontweight`              | `"demi"` and `"light"`
+  `uicontrol`          | `fontweight`              | `"demi"` and `"light"`
+  `uipanel`            | `fontweight`              | `"demi"` and `"light"`
+  `uibuttongroup`      | `fontweight`              | `"demi"` and `"light"`
+  `uitable`            | `fontweight`              | `"demi"` and `"light"`
 
-See NEWS.5 for old news.
+
+
+### Alphabetical list of new functions added in Octave 6
+
+- `lightangle`
+- `verLessThan`
+
+
+### Old release news
+
+- [Octave 5.x](etc/NEWS.5)
+- [Octave 4.x](etc/NEWS.4)
+- [Octave 3.x](etc/NEWS.3)
+- [Octave 2.x](etc/NEWS.2)
+- [Octave 1.x](etc/NEWS.1)