GTROFF(1) GTROFF(1) NNAAMMEE gtroff - format documents SSYYNNOOPPSSIISS ggttrrooffff [ --aabbiivvzzCCEERR ] [ --ww_n_a_m_e ] [ --WW_n_a_m_e ] [ --dd_c_s ] [ --ff_f_a_m ] [ --mm_n_a_m_e ] [ --nn_n_u_m ] [ --oo_l_i_s_t ] [ --rr_c_n ] [ --TT_n_a_m_e ] [ --FF_d_i_r ] [ --MM_d_i_r ] [ _f_i_l_e_s_._._. ] DDEESSCCRRIIPPTTIIOONN This manual page describes the GNU version of ttrrooffff, which is part of the groff document formatting system. It is highly compatible with Unix troff. Usually it should be invoked using the groff command, which will also run pre- processors and postprocessors in the appropriate order and with the appropriate options. OOPPTTIIOONNSS --aa Generate an ASCII approximation of the typeset output. --bb Print a backtrace with each warning or error message. This backtrace should help track down the cause of the error. The line numbers given in the backtrace may not always correct: troff's idea of line numbers gets confused by aass or aamm requests. --ii Read the standard input after all the named input files have been processed. --vv Print the version number. --ww_n_a_m_e Enable warning _n_a_m_e. Available warnings are described in the Warnings subsection below. Multiple --ww options are allowed. --WW_n_a_m_e Inhibit warning _n_a_m_e. Multiple --WW options are allowed. --EE Inhibit all error messages. --zz Suppress formatted output. --CC Enable compatibility mode. --dd_c_s --dd_n_a_m_e==_s Define _c or _n_a_m_e to be a string _s; _c must be a one letter name. --ff_f_a_m Use _f_a_m as the default font family. --mm_n_a_m_e Read in the file ttmmaacc.._n_a_m_e. Normally this will be searched for in /u1/gnu/lib/groff/tmac. Groff Version 1.08 1 April 1993 1 GTROFF(1) GTROFF(1) --RR Don't load ttrrooffffrrcc. --nn_n_u_m Number the first page _n_u_m. --oo_l_i_s_t Output only pages in _l_i_s_t, which is a comma- separated list of page ranges; _n means print page _n, _m--_n means print every page between _m and _n, --_n means print every page up to _n, _n-- means print every page from _n. --rr_c_n --rr_n_a_m_e==_n Set number register _c or _n_a_m_e to _n; _c must be a one character name; _n can be any troff numeric expression. --TT_n_a_m_e Prepare output for device _n_a_m_e, rather than the default ppss. --FF_d_i_r Search _d_i_r for subdirectories ddeevv_n_a_m_e (_n_a_m_e is the name of the device) for the DDEESSCC file and font files before the normal //uu11//ggnnuu//lliibb//ggrrooffff//ffoonntt. --MM_d_i_r Search directory _d_i_r for macro files before the normal //uu11//ggnnuu//lliibb//ggrrooffff//ttmmaacc. UUSSAAGGEE Only the features not in Unix troff are described here. LLoonngg nnaammeess The names of number registers, fonts, strings/macros/diversions, special characters can be of any length. In escape sequences, where you can use ((_x_x for a two character name, you can use [[_x_x_x]] for a name of arbitrary length: \\[[_x_x_x]] Print the special character called _x_x_x. \\ff[[_x_x_x]] Set font _x_x_x. \\**[[_x_x_x]] Interpolate string _x_x_x. \\nn[[_x_x_x]] Interpolate number register _x_x_x. FFrraaccttiioonnaall ppooiinnttssiizzeess A _s_c_a_l_e_d _p_o_i_n_t is equal to 1/sizescale points, where sizescale is specified in the DDEESSCC file (1 by default.) There is a new scale indicator zz which has the effect of multiplying by sizescale. Requests and escape sequences in troff interpret arguments that represent a pointsize as being in units of scaled points, but they evaluate each Groff Version 1.08 1 April 1993 2 GTROFF(1) GTROFF(1) such argument using a default scale indicator of zz. Argu- ments treated in this way are the argument to the ppss request, the third argument to the ccss request, the second and fourth arguments to the ttkkff request, the argument to the \\HH escape sequence, and those variants of the \\ss escape sequence that take a numeric expression as their argument. For example, suppose sizescale is 1000; then a scaled point will be equivalent to a millipoint; the request ..ppss 1100..2255 is equivalent to ..ppss 1100..2255zz and so sets the point- size to 10250 scaled points, which is equal to 10.25 points. The number register \\nn((..ss returns the pointsize in points as decimal fraction. There is also a new number register \\nn[[..ppss]] that returns the pointsize in scaled points. It would make no sense to use the zz scale indicator in a numeric expression whose default scale indicator was nei- ther uu nor zz, and so ttrrooffff disallows this. Similarily it would make no sense to use a scaling indicator other than zz or uu in a numeric expression whose default scale indica- tor was zz, and so ttrrooffff disallows this as well. There is also new scale indicator ss which multiplies by the number of units in a scaled point. So, for example, \\nn[[..ppss]]ss is equal to 11mm. Be sure not to confuse the ss and zz scale indicators. NNuummeerriicc eexxpprreessssiioonnss Spaces are permitted in a number expression within paren- theses. MM indicates a scale of 100ths of an em. _e_1>>??_e_2 The maximum of _e_1 and _e_2. _e_1<