Arrange macros alphabetically

This relieves the programmer of the burden of having to decide
where new macros should be placed.

1 files changed, 74 insertions, 72 deletions

diff --git a/g.tmac b/g.tmac
index 9a510eb..ae86c64 100644
--- a/g.tmac
+++ b/g.tmac
@@ -6,15 +6,18 @@
 .\" distribute this software for any purpose "/.
 .\" with or without fee is hereby granted.   "/.
 .\"                                          "/.
-.\" For a summary of the macros defined in   "/.
-.\" this file, issue `grep -- -- g.tmac'.    "/.
+.\" For an index of the macros defined in    "/.
+.\" this file, issue `grep -n [-]- g.tmac'.  "/.
+.\"                                          "/.
+.\" Place new macros in alphabetical order.  "/.
+.\"                                          "/.
 .
 .eo \" disable backslash escapes
 .
 .\" Internal macros ----------------------------
 .
-.\" _s -- setup document
-.de _s
+.\" _a -- setup document
+.de _a
 .
 . \" configure initial options
 . _nr mt 1i \" margin top
@@ -29,16 +32,6 @@
 . ns
 .
 . \" configure environments
-. t \" title
-.  evc 0
-.  ps +4p
-.  vs +2p
-.  ft B
-.  ad c
-. n \" name (of author)
-.  evc 0
-.  nr sp 0.4v
-.  ad c
 . d \" date
 .  evc 0
 .  nr sp 0.4v
@@ -48,15 +41,6 @@
 .  nr sp 0.6v
 .  ps +1p
 .  ft B
-. s \" section heading
-.  evc 0
-.  nr sp 0.6v
-.  ft B
-. p \" paragraph
-.  evc 0
-.  nr sp 0.3v
-.  nr ti 0.5c
-.  ad b
 . l \" literal display
 .  evc 0
 .  nr sp 0.3v
@@ -65,6 +49,15 @@
 .  fam C
 .  ps -1p
 .  vs -1p
+. n \" name (of author)
+.  evc 0
+.  nr sp 0.4v
+.  ad c
+. p \" paragraph
+.  evc 0
+.  nr sp 0.3v
+.  nr ti 0.5c
+.  ad b
 . q \" quotation
 .  evc 0
 .  nr sp 0.3v
@@ -72,26 +65,19 @@
 .  in 0.5c
 .  ps -1p
 .  vs -1p
+. s \" section heading
+.  evc 0
+.  nr sp 0.6v
+.  ft B
+. t \" title
+.  evc 0
+.  ps +4p
+.  vs +2p
+.  ft B
+.  ad c
 . _e
 ..
 .
-.\" _h -- page header
-.de _h
-' sp \n(mtu
-..
-.
-.\" _f -- page footer
-.de _f
-' sp 1v
-. tl ''%''
-' bp
-..
-.
-.\" _nr -- set default numeric value
-.de _nr
-. if \n[\$1]=0 .nr \$1 \$2
-..
-.
 .\" _ds -- set default string value
 .de _ds
 . if '\*[\$1]'' .ds \$1 \$2
@@ -101,9 +87,9 @@
 .de _e
 .
 . \" initialize document?
-. if '\n(_s'0' \{\
-.  nr _s 1
-.  _s
+. if '\n(_a'0' \{\
+.  nr _a 1
+.  _a
 . \}
 .
 . br
@@ -131,6 +117,23 @@
 . _pe
 ..
 .
+.\" _f -- page footer
+.de _f
+' sp 1v
+. tl ''%''
+' bp
+..
+.
+.\" _h -- page header
+.de _h
+' sp \n(mtu
+..
+.
+.\" _nr -- set default numeric value
+.de _nr
+. if \n[\$1]=0 .nr \$1 \$2
+..
+.
 .\" _pe -- post-environment operations
 .de _pe
 .
@@ -156,16 +159,6 @@
 \$3\fB\$1\fP\$2
 ..
 .
-.\" i -- italic font
-.de i
-\$3\fI\$1\fP\$2
-..
-.
-.\" x -- bold italic font
-.de x
-\$3\f(BI\$1\fP\$2
-..
-.
 .\" c -- constant-width font
 .de c
 \$3\c
@@ -177,16 +170,26 @@
 \$2
 ..
 .
+.\" i -- italic font
+.de i
+\$3\fI\$1\fP\$2
+..
+.
+.\" x -- bold italic font
+.de x
+\$3\f(BI\$1\fP\$2
+..
+.
 .
 .\" Hybrid macros ------------------------------
 .
 .\" q -- quotation
 .de q
 .
-. \" inline quotation
+. \" inline
 . ie !'\$1'' \$3\(lq\$1\(rq\$2
 .
-. \" block quotation
+. \" block
 . el \{\
 .  _e q
 .  ti \n(tiu
@@ -196,15 +199,6 @@
 .
 .\" Environment macros -------------------------
 .
-.\" t -- title
-.de t
-. _e t
-..
-.
-.\" n -- name (of author)
-.de n
-. _e n
-..
 .
 .\" d -- date
 .de d
@@ -216,26 +210,34 @@
 . af mo 1
 . af dy 1
 ..
-.
 .\" h -- heading
 .de h
 . _e h
 .
 ..
-.\" s -- section heading
-.de s
-. _e s
-.
+.\" l -- literal display
+.de l
+. _e l
 ..
+.\" n -- name (of author)
+.de n
+. _e n
+..
+.
 .\" p -- paragraph
 .de p
 . _e p
 . if '\*[penv]'p' .ti \n(tiu
 ..
 .
-.\" l -- literal display
-.de l
-. _e l
+.\" s -- section heading
+.de s
+. _e s
+..
+.
+.\" t -- title
+.de t
+. _e t
 ..
 .
 .ec \" re-enable backslash escapes