Extra documentation of graphical picture editor

2012-03-07 18:57:05 +00:00 · 2012-03-07 18:57:05 +00:00 · c5485a0a6f
parent 8951f4d8f7
commit c5485a0a6f
4 changed files with 213 additions and 3 deletions
--- a/main/graphics/man-graphics-edit.en.tm
+++ b/main/graphics/man-graphics-edit.en.tm
@ -3,9 +3,59 @@
 <style|tmdoc>

 <\body>
-  <tmdoc-title|Inserting and editing objects>
+  <tmdoc-title|Editing objects>

-  \;
+  Any of the modes which allows for the insertion of new objects (points,
+  lines, polygons, etc.) also allows you to directly edit existing objects.
+  More precisely, as soon as you go over an existing object with your mouse,
+  then the control points for that object will be highlighted automatically.
+  Several editing operations are supported:
+
+  <\description>
+    <item*|Moving control points>When your mouse is sufficiently close to a
+    control point, then it will be possible to drag and drop the control
+    point to somewhere else using the left mouse button.
+
+    <item*|Inserting new control points>For objects with an arbitrary number
+    of control points, such as broken lines, polygons, splines and closed
+    splines, it is possible to insert new points on existing edges. In order
+    to do so, move the mouse pointer on the edge where you want to insert a
+    new point; the two neighbouring control points should be highlighted.
+    Then insert a new point drag and move it around using drag and drop for
+    the first mouse button.
+
+    <item*|Removing control points>Using the middle mouse button, it is
+    possible to remove control points (and eventually the object itself).
+
+    <item*|Removing the entire object>Using the middle mouse button while
+    simultaneously pressing the shift key <key|shift> removes the entire
+    object which is currently highlighted.
+  </description>
+
+  While editing, it should also be noticed that <TeXmacs> attempts to
+  automatically <em|snap> the mouse pointer to control points or edges of
+  existing objects, as well as to intersection points of two curves and
+  points on the grid. This makes it possible to quickly draw complex pictures
+  which are exact, and not merely exact up to one or more pixels (and ugly
+  when magnified or printed). Around boxes with text or mathematical
+  formulas, there are also eight invisible control points to which <TeXmacs>
+  will attempt to snap the mouse pointer. This makes it easier to draw
+  diagrams as in figure<nbsp><reference|diagram-fig> below.
+
+  Graphical objects are drawn in a specific <em|stacking order> which has the
+  effect that certain objects may be hidden by other objects. Using
+  <shortcut|(graphics-zmove 'closer)> and <shortcut|(graphics-zmove
+  'farther)>, you may move the currently highlighted object closer to or
+  farther away from the eye for this stacking order. In a similar vein,
+  certain control points may become unaccessible, because hidden by closer
+  control points. In that case, you may use <key|tab> to cycle through all
+  possibilities for the current cursor position.
+
+  <\big-figure|<with|gr-mode|<tuple|edit|spline>|gr-frame|<tuple|scale|1cm|<tuple|0.729978gw|0.140033gh>>|gr-geometry|<tuple|geometry|1par|0.6par>|gr-grid|<tuple|empty>|gr-grid-old|<tuple|cartesian|<point|0|0>|1>|gr-edit-grid-aspect|<tuple|<tuple|axes|none>|<tuple|1|none>|<tuple|10|none>>|gr-edit-grid|<tuple|empty>|gr-edit-grid-old|<tuple|cartesian|<point|0|0>|1>|gr-text-at-halign|center|gr-arrow-end|\<gtr\>|gr-auto-crop|true|<graphics||<with|text-at-halign|center|<math-at|A|<point|-5|3>>>|<with|text-at-halign|center|<math-at|B|<point|-3.5|3>>>|<with|text-at-halign|center|<math-at|C|<point|-5|2>>>|<with|text-at-halign|center|<math-at|D|<point|-3.5|2>>>|<with|text-at-halign|center|<math-at|X|<point|-2|3>>>|<with|text-at-halign|center|<math-at|Y|<point|-2|2>>>|<with|arrow-end|\<gtr\>|<line|<point|-4.75015|3.12052>|<point|-3.75133946289192|3.1205185871147>>>|<with|arrow-end|\<gtr\>|<line|<point|-5|2.88244>|<point|-5.0|2.35861225029766>>>|<with|arrow-end|\<gtr\>|<line|<point|-4.75637|2.12052>|<point|-3.76357653128721|2.1205185871147>>>|<with|arrow-end|\<gtr\>|<line|<point|-3.5|2.88244>|<point|-3.5|2.35861225029766>>>|<with|arrow-end|\<gtr\>|<line|<point|-3.24864|3.12052>|<point|-2.26367575076068|3.1205185871147>>>|<with|arrow-end|\<gtr\>|<line|<point|-3.23641|2.12052>|<point|-2.21995303611589|2.1205185871147>>>|<with|arrow-end|\<gtr\>|<line|<point|-2|2.88244>|<point|-2.0|2.35861225029766>>>|<with|arrow-end|\<gtr\>|<spline|<point|-4.75015|3.35861>|<point|-2.87767892578383|3.71332186797195>|<point|-1.31133417118666|3.26881862680249>|<point|-1.7800304273052|2.35861225029766>>>>>>
+    <label|diagram-fig>Example of a diagram which was drawn by using snapping
+    to the eight control points around each box with a mathematical formula.
+    Notice also that we cropped the graphics to its actual size.
+  </big-figure>

  <tmdoc-copyright|2012|Joris van der Hoeven>

--- a/main/graphics/man-graphics-insert.en.tm
+++ b/main/graphics/man-graphics-insert.en.tm
@ -0,0 +1,82 @@
+<TeXmacs|1.0.7.14>
+
+<style|tmdoc>
+
+<\body>
+  <tmdoc-title|Inserting new objects>
+
+  After insertion of a new picture or clicking inside an existing picture,
+  the second mode dependent toolbar shows a<nbsp>list of icons which are
+  useful in graphics mode. In particular, the second group of icons
+  <icon|tm_point_mode.xpm>, <icon|tm_line_mode.xpm>,
+  <icon|tm_cline_mode.xpm>, <icon|tm_spline_mode.xpm>,
+  <icon|tm_cspline_mode.xpm>, <icon|tm_arc_mode.xpm>,
+  <icon|tm_carc_mode.xpm>, <icon|tm_textat_mode.xpm>, <icon|tm_math.xpm> on
+  this toolbar allows you to select the kind of objects that you want to
+  insert. <TeXmacs> currently implements the following primitive graphical
+  objects:
+
+  <\description>
+    <item*|Points>When selecting point mode using <icon|tm_point_mode.xpm> or
+    <menu|Insert|Point>, you may insert simple points with the left mouse
+    button.
+
+    <item*|Lines and polygons>When selecting line mode using
+    <icon|tm_line_mode.xpm> or <menu|Insert|Line>, you may insert a new
+    broken line with the left mouse button: at every new click a new point is
+    inserted and the last point is inserted using a double click. Polygon
+    mode (<icon|tm_cline_mode.xpm> or <menu|Insert|Polygon>) is a variant of
+    line mode, with this difference that an additional segment is inserted
+    between the first and the last points.
+
+    <item*|Splines and closed splines>Spline mode is selected using
+    <icon|tm_spline_mode.xpm> or <menu|Insert|Spline>. This mode is similar
+    to line mode, except that we now draw a smooth curve through the
+    specified points. Again, this mode admits a closed variant
+    (<icon|tm_cspline_mode.xpm> or <menu|Insert|Closed spline>).
+
+    <item*|Arcs and circles>Arc mode is selected using <icon|tm_arc_mode.xpm>
+    or <menu|Insert|Arc>. In this mode, you may insert arcs going through
+    three points specified through left mouse clicks. Similarly, you may use
+    circle mode (<icon|tm_carc_mode.xpm> or <menu|Insert|Circle>) for drawing
+    circles.
+
+    <item*|Text and mathematics>When selecting text mode
+    (<icon|tm_textat_mode.xpm> or <menu|Insert|Text>) or mathematics mode
+    (<icon|tm_math.xpm> or <menu|Insert|Mathematics>), you may enter text (or
+    mathematics) at an arbitrary position in the picture, again using the
+    left mouse button.
+  </description>
+
+  Typical examples of these basic objects are shown in the figures below:
+
+  <\center>
+    <tabular*|<tformat|<table|<row|<cell|<small-figure|<with|gr-mode|point|gr-frame|<tuple|scale|1cm|<tuple|0.5gw|0.5gh>>|gr-geometry|<tuple|geometry|3cm|3cm|center>|<graphics||<point|0.499041|-0.00699497>|<point|-0.919136|-0.23983>|<point|0.329706|-1.19234>>>|Points.>>|<cell|<small-figure|<with|gr-mode|<tuple|edit|line>|gr-frame|<tuple|scale|1cm|<tuple|0.5gw|0.5gh>>|gr-geometry|<tuple|geometry|3cm|3cm|center>|<graphics||<line|<point|-0.926313|0.839678>|<point|0.809366318296071|0.564509194337875>|<point|-0.862812541341447|-0.13399589892843>|<point|1.04220134938484|-0.260996824976849>|<point|-0.121973806059003|-1.17117012832385>>>>|Lines.>>|<cell|<small-figure|<with|gr-mode|<tuple|edit|cline>|gr-frame|<tuple|scale|1cm|<tuple|0.5gw|0.5gh>>|gr-geometry|<tuple|geometry|3cm|3cm|center>|<graphics||<cline|<point|-0.742988|0.839678>|<point|0.844523085064162|0.691510120386294>|<point|0.886856727080302|-0.769000529170525>|<point|-0.425486175420029|-1.2770042333642>|<point|-1.25099219473475|-0.13399589892843>>>>|Polygons.>>>>>>
+
+    \;
+
+    <tabular*|<tformat|<table|<row|<cell|<small-figure|<with|gr-mode|<tuple|edit|spline>|gr-frame|<tuple|scale|1cm|<tuple|0.5gw|0.5gh>>|gr-geometry|<tuple|geometry|3cm|3cm|center>|<graphics||<spline|<point|-1.1308|1.0844>|<point|0.880043656568329|0.661066278608281>|<point|-0.855635666093399|-0.0374388146580235>|<point|0.901210477576399|-0.48194205582749>|<point|-0.516966529964281|-1.1804471490938>>>>|Splines.>>|<cell|<small-figure|<with|gr-mode|<tuple|edit|cspline>|gr-frame|<tuple|scale|1cm|<tuple|0.5gw|0.5gh>>|gr-geometry|<tuple|geometry|3cm|3cm|center>|<graphics||<cspline|<point|-0.651144|0.788067>|<point|0.89403360232835|0.322397142479164>|<point|0.640031750231512|-0.905278475988887>|<point|-0.566477047228469|-1.20161397010187>|<point|-1.15914803545443|-0.206773382722582>>>>|Closed
+    splines.>>|<cell|<small-figure|<with|gr-mode|<tuple|edit|arc>|gr-frame|<tuple|scale|1cm|<tuple|0.5gw|0.5gh>>|gr-geometry|<tuple|geometry|3cm|3cm|center>|<graphics||<arc|<point|-0.827656|-1.15928>|<point|0.865689906072232|-0.5454425188517>|<point|-0.806488953565286|0.87273448868898>>>>|Arcs.>>>>>>
+
+    \;
+
+    <tabular*|<tformat|<table|<row|<cell|<small-figure|<with|gr-mode|<tuple|edit|carc>|gr-frame|<tuple|scale|1cm|<tuple|0.5gw|0.5gh>>|gr-geometry|<tuple|geometry|3cm|3cm|center>|<graphics||<carc|<point|-0.262964677867443|0.990458393967456>|<point|1.02821140362482|-0.0467158354279667>|<point|-0.0724632887948141|-1.1473905278476>>>>|Circles.>>|<cell|<small-figure|<with|gr-mode|<tuple|edit|text-at>|gr-frame|<tuple|scale|1cm|<tuple|0.5gw|0.5gh>>|gr-geometry|<tuple|geometry|3cm|3cm|center>|<graphics||<text-at|Hello|<point|-0.164307|0.545955>>>>|Text.>>|<cell|<small-figure|<with|gr-mode|<tuple|edit|math-at>|gr-frame|<tuple|scale|1cm|<tuple|0.5gw|0.5gh>>|gr-geometry|<tuple|geometry|3cm|3cm|center>|<graphics||<math-at|\<mathe\><rsup|\<mathpi\>*\<mathi\>>=-1|<point|-1.08166|-0.533553>>>>|Mathematics.>>>>>>
+  </center>
+
+  <htab|5mm>
+
+  <tmdoc-copyright|2012|Joris van der Hoeven>
+
+  <tmdoc-license|Permission is granted to copy, distribute and/or modify this
+  document under the terms of the GNU Free Documentation License, Version 1.1
+  or any later version published by the Free Software Foundation; with no
+  Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
+  Texts. A copy of the license is included in the section entitled "GNU Free
+  Documentation License".>
+</body>
+
+<\initial>
+  <\collection>
+    <associate|language|english>
+  </collection>
+</initial>
--- a/main/graphics/man-graphics-style.en.tm
+++ b/main/graphics/man-graphics-style.en.tm
@ -5,6 +5,82 @@
 <\body>
  <tmdoc-title|Specification of style properties>

+  Each of the fundamental types of graphical objects also admits a certain
+  number of style properties which affect the rendering. The following style
+  properties exist:
+
+  <paragraph|Color>This property applies to any of the graphical object types
+  and specifies the color.
+
+  <paragraph|Fill color>This property applies to all graphical object types
+  except text and mathematics. It specifies a fill color for the object.
+
+  <\big-figure|<with|gr-mode|<tuple|edit|cspline>|gr-frame|<tuple|scale|1cm|<tuple|0.5gw|0.5gh>>|gr-geometry|<tuple|geometry|1par|0.6par>|gr-fill-color|pastel
+  red|gr-color|dark magenta|gr-auto-crop|true|<graphics||<cspline|<point|-4.82503|-0.183391>|<point|-4.54985778542135|2.12379282973938>|<point|-3.34334898796137|1.57345548352957>|<point|-2.623677073687|0.070611191956608>|<point|-3.89368633417119|0.790283106230983>>|<with|fill-color|pastel
+  yellow|<cspline|<point|-1.75584|2.22963>|<point|-2.24267429554174|1.23478634740045>|<point|-1.62883648630771|0.324613044053446>|<point|-1.88283833840455|1.21361952639238>>>|<with|color|dark
+  blue|fill-color|pastel orange|<cspline|<point|-0.0201581|1.78512>|<point|-0.845664109009128|1.36178727344887>|<point|-0.464661330863871|0.493947612118005>|<point|0.424345151475063|0.917284032279402>>>|<with|color|dark
+  magenta|fill-color|pastel red|<cspline|<point|2.11769|1.99679>|<point|2.81619592538696|0.811449927239053>|<point|1.56735348591083|0.769116285222913>>>>>>
+    Examples of a few closed splines with different colors and fill colors.
+  </big-figure>
+
+  <paragraph|Opacity>This property also applies to any of the graphical
+  object types and specifies an opacity between 0% and 100%. The default is
+  100% and lower opacities will make the object more transparent.
+
+  <big-figure|<with|gr-mode|<tuple|edit|carc>|gr-frame|<tuple|scale|1cm|<tuple|0.5gw|0.5gh>>|gr-geometry|<tuple|geometry|1par|0.6par>|gr-grid|<tuple|empty>|gr-grid-old|<tuple|cartesian|<point|0|0>|1>|gr-edit-grid-aspect|<tuple|<tuple|axes|none>|<tuple|1|none>|<tuple|10|none>>|gr-edit-grid|<tuple|empty>|gr-edit-grid-old|<tuple|cartesian|<point|0|0>|1>|gr-fill-color|pastel
+  green|gr-color|dark green|gr-opacity|20%|gr-auto-crop|true|<graphics||<with|color|dark
+  brown|fill-color|brown|<cline|<point|-5|1>|<point|-5.0|-1.0>|<point|5.0|-1.0>|<point|5.0|1.0>>>|<with|color|dark
+  green|fill-color|pastel green|<carc|<point|4|-1.5>|<point|4.5|-1.0>|<point|4.0|-0.5>>>|<with|color|dark
+  green|opacity|80%|fill-color|pastel green|<carc|<point|2|-1.5>|<point|2.5|-1.0>|<point|2.0|-0.5>>>|<with|color|dark
+  green|opacity|60%|fill-color|pastel green|<carc|<point|0|-1.5>|<point|0.5|-1.0>|<point|0.0|-0.5>>>|<with|color|dark
+  green|opacity|40%|fill-color|pastel green|<carc|<point|-2|-1.5>|<point|-1.5|-1.0>|<point|-2.0|-0.5>>>|<with|color|dark
+  green|opacity|20%|fill-color|pastel green|<carc|<point|-4|-1.5>|<point|-3.5|-1.0>|<point|-4.0|-0.5>>>>>|Examples
+  of the same object with increasing opacities on top of another object.>
+
+  <paragraph|Point style>A few different point styles are supported for
+  displaying points: solid disks, round circles and squares.
+
+  <big-figure|<with|gr-mode|<tuple|edit|text-at>|gr-frame|<tuple|scale|1cm|<tuple|0.5gw|0.5gh>>|gr-geometry|<tuple|geometry|1par|0.6par>|gr-fill-color|red|gr-grid|<tuple|empty>|gr-grid-old|<tuple|cartesian|<point|0|0>|1>|gr-edit-grid-aspect|<tuple|<tuple|axes|none>|<tuple|1|none>|<tuple|10|none>>|gr-edit-grid|<tuple|empty>|gr-edit-grid-old|<tuple|cartesian|<point|0|0>|1>|gr-point-style|square|gr-text-at-halign|center|gr-auto-crop|true|<graphics||<with|fill-color|red|<point|-2|0>>|<with|fill-color|red|point-style|round|<point|0|0>>|<with|fill-color|red|point-style|square|<point|2|0>>|<with|text-at-halign|center|<text-at|Square|<point|2|0.5>>>|<with|text-at-halign|center|<text-at|Round|<point|0|0.5>>>|<with|text-at-halign|center|<text-at|Disk|<point|-2|0.5>>>>>|The
+  different point styles for black color and red fill color.>
+
+  <paragraph|Line width>The line width property applies to all curves (that
+  is, to broken lines, polygons, splines, closed splines, arcs and circles).
+  By default it is <verbatim|1ln>, the width of the fraction bar in
+  mathematical formulas, but any <TeXmacs> length unit can be used instead.
+
+  <\big-figure|<with|gr-mode|<tuple|edit|text-at>|gr-frame|<tuple|scale|1cm|<tuple|0.5gw|0.5gh>>|gr-geometry|<tuple|geometry|1par|0.6par>|gr-grid|<tuple|empty>|gr-grid-old|<tuple|cartesian|<point|0|0>|1>|gr-edit-grid-aspect|<tuple|<tuple|axes|none>|<tuple|1|none>|<tuple|10|none>>|gr-edit-grid|<tuple|empty>|gr-edit-grid-old|<tuple|cartesian|<point|0|0>|1>|gr-line-width|5ln|gr-auto-crop|true|<graphics||<spline|<point|-3|0>|<point|-2.0|0.3>|<point|0.0|-0.3>|<point|2.0|0.3>|<point|3.0|0.0>>|<with|line-width|0.5ln|<spline|<point|-3|1>|<point|-2.0|1.3>|<point|0.0|0.7>|<point|2.0|1.3>|<point|3.0|1.0>>>|<with|line-width|2ln|<spline|<point|-3|-1>|<point|-2.0|-0.7>|<point|0.0|-1.3>|<point|2.0|-0.7>|<point|3.0|-1.0>>>|<with|line-width|5ln|<spline|<point|-3|-2>|<point|-2.0|-1.7>|<point|0.0|-2.3>|<point|2.0|-1.7>|<point|3.0|-2.0>>>|<text-at|0.5ln|<point|3.5|1>>|<text-at|1ln|<point|3.5|0>>|<text-at|2ln|<point|3.5|-1>>|<text-at|5ln|<point|3.5|-2>>>>>
+    The same curve using different line widths.
+  </big-figure>
+
+  <paragraph|Line dashes>Various dash styles are available for curves in
+  <menu|Focus|Line dashes>.
+
+  <\big-figure|<with|gr-mode|<tuple|edit|line>|gr-frame|<tuple|scale|1cm|<tuple|0.5gw|0.5gh>>|gr-geometry|<tuple|geometry|1par|0.6par>|gr-grid|<tuple|empty>|gr-grid-old|<tuple|cartesian|<point|0|0>|1>|gr-edit-grid-aspect|<tuple|<tuple|axes|none>|<tuple|1|none>|<tuple|10|none>>|gr-edit-grid|<tuple|empty>|gr-edit-grid-old|<tuple|cartesian|<point|0|0>|1>|gr-line-width|2ln|gr-dash-style|11100|gr-dash-style-unit|20ln|gr-auto-crop|true|<graphics||<with|line-width|2ln|<line|<point|-3|1>|<point|-2.0|1.5>|<point|0.0|0.5>|<point|2.0|1.5>|<point|3.0|1.0>>>|<with|dash-style|10|line-width|2ln|<line|<point|-3|0.5>|<point|-2.0|1.0>|<point|0.0|0.0>|<point|2.0|1.0>|<point|3.0|0.5>>>|<with|dash-style|11100|line-width|2ln|<line|<point|-3|0>|<point|-2.0|0.5>|<point|0.0|-0.5>|<point|2.0|0.5>|<point|3.0|0.0>>>|<with|dash-style|1111010|line-width|2ln|<line|<point|-3|-0.5>|<point|-2.0|0.0>|<point|0.0|-1.0>|<point|2.0|0.0>|<point|3.0|-0.5>>>|<with|dash-style|1111010|line-width|2ln|dash-style-unit|10ln|<line|<point|-3|-1>|<point|-2.0|-0.5>|<point|0.0|-1.5>|<point|2.0|-0.5>|<point|3.0|-1.0>>>|<with|dash-style|11100|line-width|2ln|dash-style-unit|20ln|<line|<point|-3|-1.5>|<point|-2.0|-1.0>|<point|0.0|-2.0>|<point|2.0|-1.0>|<point|3.0|-1.5>>>>>>
+    The same curve using different dashing styles.
+  </big-figure>
+
+  <paragraph|Line arrows>Various arrows at the ends of curves are supported
+  in <menu|Focus|Line arrows>.
+
+  <\big-figure|<with|gr-mode|<tuple|edit|line>|gr-frame|<tuple|scale|1cm|<tuple|0.5gw|0.5gh>>|gr-geometry|<tuple|geometry|1par|0.6par>|gr-grid|<tuple|empty>|gr-grid-old|<tuple|cartesian|<point|0|0>|1>|gr-edit-grid-aspect|<tuple|<tuple|axes|none>|<tuple|1|none>|<tuple|10|none>>|gr-edit-grid|<tuple|empty>|gr-edit-grid-old|<tuple|cartesian|<point|0|0>|1>|gr-line-width|2ln|gr-arrow-begin|\||gr-arrow-end|\||gr-auto-crop|true|<graphics||<with|line-width|2ln|<line|<point|-4|2>|<point|-1.0|2.0>>>|<with|arrow-end|\<gtr\>|line-width|2ln|<line|<point|-4|1.5>|<point|-1.0|1.5>>>|<with|arrow-end|\|\<gtr\>|line-width|2ln|<line|<point|-4|1>|<point|-1.0|1.0>>>|<with|arrow-end|\<gtr\>\<gtr\>|line-width|2ln|<line|<point|-4|0.5>|<point|-1.0|0.5>>>|<with|arrow-end|\<less\>|line-width|2ln|<line|<point|-4|0>|<point|-1.0|0.0>>>|<with|arrow-end|\<less\>\||line-width|2ln|<line|<point|-4|-0.5>|<point|-1.0|-0.5>>>|<with|arrow-end|\<less\>\<less\>|line-width|2ln|<line|<point|-4|-1>|<point|-1.0|-1.0>>>|<with|arrow-end|\||line-width|2ln|<line|<point|-4|-1.5>|<point|-1.0|-1.5>>>|<with|arrow-end|o|line-width|2ln|<line|<point|-4|-2>|<point|-1.0|-2.0>>>|<with|arrow-end|\|\<gtr\>|line-width|2ln|arrow-begin|\<less\>\||<line|<point|0|2>|<point|3.0|2.0>>>|<with|arrow-end|\|\<gtr\>|line-width|2ln|arrow-begin|\<gtr\>|<line|<point|0|1.5>|<point|3.0|1.5>>>|<with|arrow-end|o|line-width|2ln|arrow-begin|o|<line|<point|0|1>|<point|3.0|1.0>>>|<with|arrow-end|\<less\>\||line-width|2ln|arrow-begin|\|\<gtr\>|<line|<point|0|0.5>|<point|3.0|0.5>>>|<with|arrow-end|\<less\>|line-width|2ln|arrow-begin|\<gtr\>|<line|<point|0|0>|<point|3.0|0.0>>>|<with|line-width|2ln|arrow-begin|\<gtr\>|<line|<point|0|-0.5>|<point|3.0|-0.5>>>|<with|arrow-end|\<gtr\>\<gtr\>|line-width|2ln|arrow-begin|\<gtr\>|<line|<point|0|-1>|<point|3.0|-1.0>>>|<with|arrow-end|\<gtr\>\<gtr\>|line-width|2ln|arrow-begin|\<gtr\>\<gtr\>|<line|<point|0|-1.5>|<point|3.0|-1.5>>>|<with|arrow-end|\||line-width|2ln|arrow-begin|\||<line|<point|0|-2>|<point|3.0|-2.0>>>>>>
+    The same segment using different types of arrows at the extremities.
+  </big-figure>
+
+  <paragraph|Text alignment>For textual and mathematical boxes, its is
+  possible to specifiy the horizontal and vertical alignement properties, as
+  indicated in the figure below:
+
+  <\big-figure|<with|gr-mode|<tuple|edit|line>|gr-frame|<tuple|scale|1cm|<tuple|0.420008gw|0.5gh>>|gr-geometry|<tuple|geometry|1par|0.6par>|gr-grid|<tuple|empty>|gr-grid-old|<tuple|cartesian|<point|0|0>|1>|gr-edit-grid-aspect|<tuple|<tuple|axes|none>|<tuple|1|none>|<tuple|10|none>>|gr-edit-grid|<tuple|empty>|gr-edit-grid-old|<tuple|cartesian|<point|0|0>|1>|gr-line-width|2ln|gr-text-at-halign|center|gr-text-at-valign|top|gr-auto-crop|true|<graphics||<with|color|light
+  grey|line-width|2ln|<line|<point|-3|2>|<point|-3.0|-2.0>>>|<with|text-at-valign|center|<text-at|Left|<point|-3|1>>>|<with|text-at-valign|center|text-at-halign|center|<text-at|Center|<point|-3|0>>>|<with|text-at-valign|center|text-at-halign|right|<text-at|Right|<point|-3|-1>>>|<with|color|light
+  grey|line-width|2ln|<line|<point|-1|0>|<point|7.0|0.0>>>|<with|text-at-valign|bottom|text-at-halign|center|<text-at|Bottom
+  <math|y>|<point|0|0>>>|<with|text-at-halign|center|<text-at|Base
+  <math|y>|<point|1.5|0>>>|<with|text-at-valign|axis|text-at-halign|center|<text-at|Axis
+  <math|y>|<point|3|0>>>|<with|text-at-valign|center|text-at-halign|center|<text-at|Center
+  <math|y>|<point|4.5|0>>>|<with|text-at-valign|top|text-at-halign|center|<text-at|Top
+  <math|y>|<point|6|0>>>>>>
+    Illustration of horizontal and vertical alignment of text boxes.
+  </big-figure>
+
  \;

  <tmdoc-copyright|2012|Joris van der Hoeven>
--- a/main/graphics/man-graphics.en.tm
+++ b/main/graphics/man-graphics.en.tm
@ -17,7 +17,9 @@
  <\traverse>
    <branch|Starting a new picture|man-graphics-new.en.tm>

-    <branch|Inserting and editing objects|man-graphics-edit.en.tm>
+    <branch|Inserting new objects|man-graphics-insert.en.tm>
+
+    <branch|Editing objects|man-graphics-edit.en.tm>

    <branch|Specification of style properties|man-graphics-style.en.tm>