[GRASS-dev] [GRASS GIS] #3949: Number examples

#3949: Number examples
-------------------------+-------------------------
Reporter: jidanni | Owner: grass-dev@…
     Type: enhancement | Status: new
Priority: minor | Milestone:
Component: Docs | Version: unspecified
Keywords: | CPU: Unspecified
Platform: Unspecified |
-------------------------+-------------------------
{{{
$ w3m -dump file:///usr/share/doc/grass-doc/html/v.segment.html | grep
^Example
Example: Extract line segment from 400m to 5000m from beginning of line 1:
Example: Create parallel 1km long line segments along first 8km of track,
Example: A series of points, spaced every 2km along the tracks
Example: A series of points, spaced every 2km along the tracks, offset
500m to
Example: A series of points, spaced every 10% of the line's length along
the
}}}

These should be called Example 1, Example 2, etc. with their own Table
of Contents entries too.
In fact just like is already implemented on v.in.ascii.html !

--
Ticket URL: <https://trac.osgeo.org/grass/ticket/3949&gt;
GRASS GIS <https://grass.osgeo.org>

#3949: Number examples
--------------------------+---------------------------------
  Reporter: jidanni | Owner: grass-dev@…
      Type: enhancement | Status: closed
  Priority: minor | Milestone: 7.8.2
Component: Docs | Version: git-releasebranch78
Resolution: fixed | Keywords: v.segment
       CPU: Unspecified | Platform: Unspecified
--------------------------+---------------------------------
Changes (by neteler):

* keywords: => v.segment
* status: new => closed
* version: unspecified => git-releasebranch78
* resolution: => fixed
* milestone: => 7.8.2

Comment:

Agreed. Fixed in

  * master:
https://github.com/OSGeo/grass/commit/c97c8beaeb66540a8cbd5c679bbd49de2a75c724
  * relbranch78:
https://github.com/OSGeo/grass/commit/4736e2d98d0e199e348de1f4642b50751098ac13

--
Ticket URL: <https://trac.osgeo.org/grass/ticket/3949#comment:1&gt;
GRASS GIS <https://grass.osgeo.org>

#3949: Number examples
--------------------------+---------------------------------
  Reporter: jidanni | Owner: grass-dev@…
      Type: enhancement | Status: closed
  Priority: minor | Milestone: 7.8.2
Component: Docs | Version: git-releasebranch78
Resolution: fixed | Keywords: v.segment
       CPU: Unspecified | Platform: Unspecified
--------------------------+---------------------------------

Comment (by jidanni):

Thanks, but I am talking about real ''numbered'' examples. Just like in a
textbook.
Only then can one say, "Professor, regarding example 3A..."

Even when just looking at a g.manual -m man page too!
{{{
$ GET
https://raw.githubusercontent.com/OSGeo/grass/c97c8beaeb66540a8cbd5c679bbd49de2a75c724/vector/v.segment/v.segment.html
| grep -i Example
<h2>EXAMPLES</h2>
The examples are based on the North Carolina sample location.
$ GET https://grass.osgeo.org/grass79/manuals/v.in.ascii.html | grep
Example
         <li class="toc"><a href="#example-1a)---standard-format-mode"
class="toc">Example 1a) - standard format mode</a></li>
         <li class="toc"><a href="#example-1b)---standard-format-mode"
class="toc">Example 1b) - standard format mode</a></li>
         <li class="toc"><a href="#example-2---point-format-mode"
class="toc">Example 2 - point format mode</a></li>
         <li class="toc"><a href="#example-3---point-format-mode"
class="toc">Example 3 - point format mode</a></li>
         <li class="toc"><a href="#example-4---point-format-mode---csv-
table" class="toc">Example 4 - point format mode - CSV table</a></li>
         <li class="toc"><a href="#example-5---point-format-mode"
class="toc">Example 5 - point format mode</a></li>
         <li class="toc"><a href="#example-6---point-format-mode"
class="toc">Example 6 - point format mode</a></li>
         <li class="toc"><a href="#example-7---point-format-mode"
class="toc">Example 7 - point format mode</a></li>
         <li class="toc"><a href="#example-8---point-format-mode"
class="toc">Example 8 - point format mode</a></li>
<h3><a name="example-1a)---standard-format-mode">Example 1a) - standard
format mode</a></h3>
<h3><a name="example-1b)---standard-format-mode">Example 1b) - standard
format mode</a></h3>
<h3><a name="example-2---point-format-mode">Example 2 - point format
mode</a></h3>
<h3><a name="example-3---point-format-mode">Example 3 - point format
mode</a></h3>
<h3><a name="example-4---point-format-mode---csv-table">Example 4 - point
format mode - CSV table</a></h3>
<h3><a name="example-5---point-format-mode">Example 5 - point format
mode</a></h3>
<h3><a name="example-6---point-format-mode">Example 6 - point format
mode</a></h3>
<h3><a name="example-7---point-format-mode">Example 7 - point format
mode</a></h3>
<h3><a name="example-8---point-format-mode">Example 8 - point format
mode</a></h3>
}}}

--
Ticket URL: <https://trac.osgeo.org/grass/ticket/3949#comment:2&gt;
GRASS GIS <https://grass.osgeo.org>

#3949: Number examples
--------------------------+---------------------------------
  Reporter: jidanni | Owner: grass-dev@…
      Type: enhancement | Status: reopened
  Priority: minor | Milestone: 7.8.2
Component: Docs | Version: git-releasebranch78
Resolution: | Keywords: v.segment
       CPU: Unspecified | Platform: Unspecified
--------------------------+---------------------------------
Changes (by jidanni):

* status: closed => reopened
* resolution: fixed =>

--
Ticket URL: <https://trac.osgeo.org/grass/ticket/3949#comment:3&gt;
GRASS GIS <https://grass.osgeo.org>

#3949: Number examples
--------------------------+---------------------------------
  Reporter: jidanni | Owner: grass-dev@…
      Type: enhancement | Status: reopened
  Priority: minor | Milestone: 7.8.2
Component: Docs | Version: git-releasebranch78
Resolution: | Keywords: v.segment
       CPU: Unspecified | Platform: Unspecified
--------------------------+---------------------------------

Comment (by jidanni):

Sure, you can say "<LI> adds the numbers. No need."

However the numbers would not survive into the g.manual -m version.

--
Ticket URL: <https://trac.osgeo.org/grass/ticket/3949#comment:4&gt;
GRASS GIS <https://grass.osgeo.org>