Heirloom Documentation Tools: Quickstart Guide Gunnar Ritter 11/5/06 So you want to explore Heirloom _t_r_o_f_f and know _t_r_o_f_f to some ex‐ tent since you have used _g_r_o_f_f or traditional _t_r_o_f_f before? Get‐ ting started is easy then: Heirloom _t_r_o_f_f supports names with more than two characters for requests, strings, number registers, and fonts like _g_r_o_f_f does. However, it operates in a compatibility mode by default and needs to be explicitly told to activate extensions. Thus unless you are processing legacy documents, the first line in a Heirloom _t_r_o_f_f document should read ....ddddoooo xxxxffffllllaaaagggg 3333 _t_r_o_f_f produces an intermediate language that needs further pro‐ cessing in order to produce PostScript output. With preprocessors and -_m_m macros, a typical command line is ppppiiiicccc iiiinnnnppppuuuutttt....ttttrrrr |||| ttttbbbbllll |||| eeeeqqqqnnnn |||| ttttrrrrooooffffffff ----mmmmmmmm |||| ddddppppoooosssstttt >>>> oooouuuuttttppppuuuutttt....ppppssss It is most convenient to have the _m_a_k_e utility let this exe‐ cute for you. See the source directory for this quickstart guide (“doc/quickstart” in the distribution) for an example. You can adapt _t_r_o_f_f to local language conventions by setting the paper size, the hyphenation language, and the input locale. For example, a document in German that is using _UUUU_TTTT_FFFF_‐_8888 as input charac‐ ter encoding would usually configure these as ....mmmmeeeeddddiiiiaaaassssiiiizzzzeeee aaaa4444 ....hhhhyyyyllllaaaannnngggg ddddeeee____DDDDEEEE ....llllcccc____ccccttttyyyyppppeeee ddddeeee____DDDDEEEE....uuuuttttffff8888 Fonts are “plug‐and‐play”: _t_r_o_f_f can directly access PostScript Type 1, TrueType, and OpenType fonts without any need for conver‐ sion. The font of this document is mounted by ....ffffpppp 1111 RRRR LLLLiiiinnnnLLLLiiiibbbbeeeerrrrttttiiiinnnneeee____RRRR oooottttffff The document _F_o_n_t _H_a_n_d_l_i_n_g _i_n _T_r_o_f_f _W_i_t_h _P_o_s_t_S_c_r_i_p_t _D_e_v_i_c_e_s ex‐ plains additional features. Further extensions you might like to explore are paragraph‐based justification, “microtypography”, hanging punctuation, _PPPP_DDDD_FFFF book‐ marks and links, floating‐point registers, and local variables per macro instance. These are documented in _J_u_s_t_i_f_i_c_a_t_i_o_n _i_n _H_e_i_r_l_o_o_m _T_r_o_f_f and in the _N_r_o_f_f/_T_r_o_f_f _U_s_e_r’_s _M_a_n_u_a_l. Heirloom _t_r_o_f_f provides a _g_r_o_f_f compatibility mode and macro set. A command line like ggggttttbbbbllll iiiinnnnppppuuuutttt....ttttrrrr |||| ttttrrrrooooffffffff ----mmmmgggg ////uuuussssrrrr////sssshhhhaaaarrrreeee////ggggrrrrooooffffffff////ccccuuuurrrrrrrreeeennnntttt////ttttmmmmaaaacccc////ssss....ttttmmmmaaaacccc \\\\ |||| ddddppppoooosssstttt >>>> oooouuuuttttppppuuuutttt....ppppssss lets you process _g_r_o_f_f macro sets and preprocessor output.