1151497Sru.ig 2151497Srudevtag.tmac - macro package for adding tags to roff documents. 3151497Sru 4151497SruFile position: <groff_source_top>/tmac/devtag.tmac 5151497SruInstalled position: groff's main macro directory. 6151497Sru 7151497Sru------------------------------------------------------------------------ 8151497Sru Legalize 9151497Sru------------------------------------------------------------------------ 10151497Sru 11151497SruThis file is part of groff, the GNU roff type-setting system. 12151497Sru 13151497SruCopyright (C) 2004 Free Software Foundation, Inc. 14151497Sruwritten by Gaius Mulley <gaius@glam.ac.uk>. 15151497Sru 16151497Srugroff is free software; you can redistribute it and/or modify it under 17151497Sruthe terms of the GNU General Public License as published by the Free 18151497SruSoftware Foundation; either version 2, or (at your option) any later 19151497Sruversion. 20151497Sru 21151497Srugroff is distributed in the hope that it will be useful, but WITHOUT 22151497SruANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 23151497SruFITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 24151497Srufor more details. 25151497Sru 26151497SruYou should have received a copy of the GNU General Public License 27151497Srualong with groff; see the file COPYING. If not, write to the Free 28151497SruSoftware Foundation, 51 Franklin St - Fifth Floor, Boston, MA 29151497Sru02110-1301, USA. 30151497Sru 31151497Sru 32151497Sru------------------------------------------------------------------------ 33151497Sru Description 34151497Sru------------------------------------------------------------------------ 35151497Sru 36151497SruA simple set of macros to provide markup devices (currently only grohtml) 37151497Sruwith tags that define the meaning of the formatted text and also 38151497Srubasic formatting instructions. It generalizes the tag concept used within 39151497Srugrohtml and in the future it is hoped that more markup based devices 40151497Srucan capitalize on this work. It also clearly defines those tags which are 41151497Sruhonoured by grohtml. Note that not all tags are included here. Some 42151497Sruof the grohtml specific tags (header specific and jobname, etc.) are 43151497Srucalled directly from within www.tmac. The tags defined here are 44151497Srureasonably generic and could be applied to other devices. 45151497Sru.. 46151497Sru. 47151497Sru.do if d DEVTAG-NH .nx 48151497Sru. 49151497Sru.nr _C \n(.C 50151497Sru.cp 0 51151497Sru. 52151497Sru.\" -------------------------------------------------------------------- 53151497Sru.\" DEVTAG <name> 54151497Sru.\" 55151497Sru.\" Emit a tag <name> 56151497Sru.\" 57151497Sru.de DEVTAG 58151497Sru. tag devtag:\\$* 59151497Sru.. 60151497Sru.\" -------------------------------------------------------------------- 61151497Sru.\" DEVTAG-NEXT <name> 62151497Sru.\" 63151497Sru.\" When the troff state changes, emit tag <name> 64151497Sru.\" 65151497Sru.de DEVTAG-NEXT 66151497Sru. taga devtag:\\$* 67151497Sru.. 68151497Sru. 69151497Sru.\" -------------------------------------------------------------------- 70151497Sru.\" SH <level> 71151497Sru.\" NH <level> 72151497Sru.\" tell device we are starting a numbered heading 73151497Sru.\" Takes a single parameter <level>. <level> 1 74151497Sru.\" is the outer most level. 75151497Sru. 76151497Sru.de DEVTAG-NH 77151497Sru. DEVTAG ".NH \\$1" 78151497Sru.. 79151497Sru.als DEVTAG-SH DEVTAG-NH 80151497Sru. 81151497Sru.\" -------------------------------------------------------------------- 82151497Sru.\" COL <n> 83151497Sru.\" indicate that the following text is aligned for the column <n> 84151497Sru.\" n: [1..MAX(n)] 85151497Sru. 86151497Sru.de DEVTAG-COL 87151497Sru. DEVTAG ".col \\$1" 88151497Sru.. 89151497Sru. 90151497Sru.\" -------------------------------------------------------------------- 91151497Sru.\" EO-H 92151497Sru.\" indicate that a header has finished. 93151497Sru. 94151497Sru.de DEVTAG-EO-H 95151497Sru. DEVTAG ".eo.h" 96151497Sru.. 97151497Sru.\" -------------------------------------------------------------------- 98151497Sru.\" EO-TL 99151497Sru.\" indicate that a title has finished. 100151497Sru. 101151497Sru.de DEVTAG-EO-TL 102151497Sru. DEVTAG ".eo.tl" 103151497Sru.. 104151497Sru.\" -------------------------------------------------------------------- 105151497Sru.\" TL 106151497Sru.\" indicate that the following text forms a title. 107151497Sru. 108151497Sru.de DEVTAG-TL 109151497Sru. DEVTAG ".tl" 110151497Sru.. 111151497Sru. 112151497Sru.\" -------------------------------------------------------------------- 113151497Sru.\" COL-NEXT <n> 114151497Sru.\" emit a column tag just before the next glyph. 115151497Sru. 116151497Sru.de DEVTAG-COL-NEXT 117151497Sru. DEVTAG-NEXT ".col \\$1" 118151497Sru.. 119151497Sru. 120151497Sru. 121151497Sru.cp \n[_C] 122151497Sru. 123151497Sru. 124151497Sru.\" -------------------------------------------------------------------- 125151497Sru.\" Emacs settings 126151497Sru.\" -------------------------------------------------------------------- 127151497Sru. 128151497Sru.\" Local Variables: 129151497Sru.\" mode: nroff 130151497Sru.\" End: 131151497Sru.\" EOF 132