.\" Texinfo Reference card, written (heretically enough) in -* nroff -*-
.\"  Format with groff -me -t -P-l -Tps
.\"
.\" Copyright (C) 1992 Free Software Foundation, Inc.
.\"     Written by Trent A. Fisher (trent@cs.pdx.edu)
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 1, or (at your option)
.\" any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.\" set up some macros (and override ones I don't like)
.rm uh
.de uh
.sp .6v
.ps +1
.ft B
\&\\$*\l'\\n(.lu-\\n(.ku'
.ft R
.ps -1
..
.de vl
.ie \\n(.$=1 .ds Vl Pre-Release Version
.el          .ds Vl Version \\$3, \\$4.
..
.vl $Header: /home/rigel/rye/trent/doc/groff/manual/RCS/texinfo-refcard,v 1.5 92/02/08 20:48:41 trent Exp $
.\" set up -me and the page dimentions
.lp
.m1 1
.m2 0
.m3 0
.m4 0
.\".fo 'Texinfo Reference Card \*(Vl''%'
.rs
.sp -5
.\" set up for landscape mode
.po -.5i
.pl 8.4i
.ll 10i     \" 14i \" legal
.2c
.\" header
.ce 2
.sz +1
.b
Texinfo Reference Card
.r
.sz -2
Copyright (C) 1992 Free Software Foundation, Inc.
.sz -2
.sp
.TS H
l l1 l.
Command	Notes	Description
.sp -6p
.hl
.TH
.sp -1
.uh "General Commands"
\einput MACRO-DEFINITIONS-FILE	LT	T{
Use the specified macro definitions file,
normally `texinfo.tex'.
T}
@include FILENAME	L	Include the file FILENAME
@setfilename INFO-FILE	L	Provide a name for the Info file.
@settitle TITLE	L	Provide a title for page headers in a printed manual.
@bye	L	Terminate TeX processing on the file.
@c COMMENT		Begin a comment (to end of line).
@comment COMMENT	\^	\^
.uh "Structuring Commands"
@node NAME, NEXT, PREV, UP	L	Define the beginning of a new node.
@menu	LIE	Mark the beginning of a menu of nodes in Info.
T{
.nf
@inforef{NODE,
\0\0\0[ENTRY], INFO-FILE}
T}		T{
.na
Make a cross reference to an Info file
for which there
is no printed manual.
T}
T{
.nf
@pxref{NODE, [ENTRY], [TOPIC],
\0\0\0[INFO-FILE], [MANUAL]}
T}		Make a reference which starts with `see'.
T{
.nf
@ref{NODE, [ENTRY], [TOPIC],
\0\0\0[INFO-FILE], [MANUAL]}
T}		Make a reference which doesn't start with `see'.
@top TITLE	LI	Indicate which node is the `top'.
T{
.nf
@xref{NODE, [ENTRY], [TOPIC],
\0\0\0[INFO-FILE], [MANUAL]}
T}		Make a reference that starts with `See'.
.uh "Chapter/Section Commands"
@chapter TITLE	LH	Begin a chapter.
@section TITLE	LH	Begin a section.
@subsection TITLE	LH	Begin a subsection.
@subsubsection TITLE	LH	Begin a subsubsection.
@appendix TITLE	LH	Begin an appendix.
@appendixsec TITLE	LH	Begin an appendix section.
@appendixsubsec TITLE	LH	Begin an appendix subsection.
@appendixsubsubsec TITLE	LH	Begin an appendix subsubsection.
@unnumbered TITLE	LH	Begin an unnumbered chapter.
@unnumberedsec TITLE	LH	Begin an unnumbered section.
@unnumberedsubsec TITLE	LH	Begin an unnumbered subsection.
@unnumberedsubsubsec TITLE	LH	Begin an unnumbered subsubsection.
@chapheading TITLE	L	Print a chapter-like heading.
@majorheading TITLE	\^	\^
@heading TITLE	L	Print an unnumbered heading.
@subheading TITLE	L	Print an unnumbered subsection-like heading.
@subsubheading TITLE	L	Print an unnumbered subsubsection-like heading.
@contents	LT	Print a complete table of contents.
@shortcontents	LT	Print a short table of contents.
@summarycontents	\^	\^
.\" Wizardry to make this column longer (only needs to be done on page 1)
.\"  Don't ask why it is way down here :-)
.ch @f -(\n(_bu-8v)
.uh "Index Commands"
@defindex INDEX	L	Define a new index.
@defcodeindex INDEX	L	Define a new index (uses @code font).
@syncodeindex FINDEX IINDEX	L	Merge FINDEX into the IINDEX.
@synindex FINDEX IINDEX	L	Merge FINDEX into the IINDEX.
@cindex ENTRY	L	Add ENTRY to the index of concepts.
@findex ENTRY	L	Add ENTRY to the index of functions.
@kindex ENTRY	L	Add ENTRY to the index of keys.
@pindex ENTRY	L	Add ENTRY to the index of programs.
@tindex ENTRY	L	Add ENTRY to the index of data types
@vindex ENTRY	L	Add ENTRY to the index of variables.
@printindex INDEX	L	Print an index.
.uh "Footnotes"
@footnote{TEXT-OF-FOOTNOTE}		Enter a footnote.
@footnotestyle STYLE	IL	Specify an Info file's footnote style.
.sp
.uh "Displays"
@display	LE	Begin a indented, unfilled example.
@example	LE	Begin an indented, unfilled example.
@smallexample	LE	Indent text to indicate an example.
@format	LE	Begin an unindented example.
@quotation	LE	Narrow the margins to indicate text that is quoted.
@lisp	LE	Begin an example of Lisp code.
@smalllisp	LE	Begin an example of Lisp code.
@cartouche	LTE	Draw a box around text.
.uh "Printed Manual Commands"
@titlepage	TLE	Indicate to Texinfo the beginning of the title page.
@title TITLE	TL	T{
.na
Set a title flush to the left-hand side of the page
.br
in a large font and underline it.
T}
@subtitle TITLE	LHT	T{
.na
In a printed manual, set a subtitle in a normal sized
.br
font flush to the right-hand side of the page.
T}
@author AUTHOR		Typeset AUTHOR flushleft and underline it.
@headings ON|OFF|SINGLE|DOUBLE	L	T{
.na
Turn headings on or off, or specify single-sided
.br
or double-sided headings.
T}
@setchapternewpage ON-OFF-ODD	L	T{
.na
Specify whether chapters start on new pages,
and if so, whether on odd-numbered new pages.
T}
@evenfooting [L] @| [C] @| [R]	LT	Specify footings for even-numbered (left-hand) pages.
@evenheading [L] @| [C] @| [R]	LT	Specify headings for even-numbered (left-hand) pages.
@everyfooting [L] @| [C] @| [R]	LT	Specify footings for every page.
@everyheading [L] @| [C] @| [R]	LT	Specify headings for every page.
@oddfooting [L] @| [C] @| [R]	LT	Specify footings for odd-numbered (right-hand) pages.
@oddheading [L] @| [C] @| [R]	LT	Specify headings for odd-numbered (right-hand) pages.
@thischapter	F	The name and number of the current chapter.
@thischaptername	F	The name and number of the current chapter.
@thisfile	F	The name of the current `@include' file.
@thispage	F	Current page number.
@thistitle	F	The name of the document.
@finalout	T	Prevent TeX from marking over-wide lines.
@smallbook	LT	Cause TeX to produce a smaller printed manual.
.uh "Definition Commands"
@defopt OPTION	LE	Format a description for a user option.
@deffn CAT NAME ARGS	LE	Format a description for a function
@deftypefn CLASS TYPE NAME ARGS	LE	Format a description for a function.
@defmac MACRO ARGS	LE	Format a description for a macro.
@defspec SPECIAL-FORM ARGS	LE	Format a description for a special form.
@deftp CAT TYPE ATTRS	LE	Format a description for a data type.
@defcv CAT CLASS NAME	LE	Format a class variable description (OO).
@defivar CLASS INST-VAR	LE	Format instance variable description (OO).
@defmethod CLASS METHOD ARGS	LE	Format a method description (OO).
@defop CAT CLASS NAME ARGS	LE	Format an operation (OO).
@deftypefun TYPE FUNCTION ARGS	LE	Format a description for a function in a typed language.
@deftypevr CLASS TYPE NAME	LE	Format a description for something like a variable in a typed language.
@deftypevar TYPE VARIABLE	LE	T{
Format a description for a variable
in a typed language.
T}
@defun FUNCTION ARGS	LE	Format a description for functions.
@defvar VARIABLE	LE	Format a description for variables.
@defvr CAT NAME	LE	Format a description for any kind of variable.
.uh "Conditionals Commands"
@ignore	LE	Begin a stretch of text that will not appear anywhere.
@ifinfo	LEI	Begin a stretch of text that will only appear in info.
@iftex	LET	Begin a stretch of text that will only appear in TeX.
@tex	LET	Enter TeX completely.
@clear FLAG	L	Unset FLAG
@set FLAG	L	Set FLAG
@ifclear FLAG	LE	If FLAG is unset, process following text.
@ifset FLAG	LE	If FLAG is set, process following text.
.sp 2
.uh "Fonts"
@titlefont{TEXT}	TF	print TEXT in a larger than normal font.
@cite{REFERENCE}	F	Highlight the name of a book or other reference.
@code{SAMPLE-CODE}	F	Highlight program name or code.
@dfn{TERM}	F	Highlight the introductory or defining use of a term.
@file{FILENAME}	F	Highlight the name of a file or directory.
@kbd{KEYBOARD-CHARS}	F	Indicate text that consists of characters of input to be typed by users.
@key{KEY-NAME}	F	Highlight KEY-NAME, a conventional name for a key on a keyboard. 
@samp{TEXT}	F	Highlight TEXT that is a literal example of a sequence of characters.
@sc{TEXT}	F	Set TEXT in a printed output in THE SMALL CAPS FONT.
@dmn{DIMENSION}	FT	Put a narrow space before DIMENSION.
@emph{TEXT}	F	Highlight TEXT.
@strong{TEXT}	F	Emphasize TEXT.
@r{TEXT}	FT	Print TEXT in roman font.
@b{TEXT}	FT	Print TEXT in bold font.
@i{TEXT}	FT	Print TEXT in italic font.
@t{TEXT}	FT	Print TEXT in a fixed-width font.
@var{META-VAR}	F	Highlight a metasyntactic variable
.uh "Glyphs, and special characters"
@.		Stands for a period that really does end a sentence.
@:	T	Preceding putuation does not end a sentence.
@@		Stands for `@'.
@{		Stands for a left-hand brace, `{'.
@}		Stands for a right-hand brace, `}'.
@bullet{}	F	Generate a large round dot.
@copyright{}	F	Generate a copyright symbol.
@dots{}	F	Insert an ellipsis: `...'.
@equiv{}	F	Equivalence symbol
@error{}	F	Symbol for error messages.
@expansion{}	F	Expansion symbol.
@minus{}	F	Generate a minus sign.
@point{}	F	Generate a symbol which indicates a point in a buffer.
@print{}	F	Generate a symbol to indicate printed output
@result{}	F	Generate a symbol to indicate the result of an expression.
@TeX{}	F	Insert the logo TeX.
@today{}	F	Insert the current date, in `1 Jan 1900' style.
.uh "Formatting commands"
@*		Force a line break.
@center LINE-OF-TEXT	L	Center the line of text following the command.
@exdent LINE-OF-TEXT	L	Remove any indentation a line might have.
@group	TLE	Hold text together that must appear on one printed page.
@paragraphindent INDENT	L	Indent paragraphs by INDENT number of spaces.
@refill	I	Refill and indent the paragraph.
@sp N	L	Skip N blank lines.
@flushleft	LE	Left justify every line but leave the right end ragged.
@flushright	LE	Right justify every line but leave the left end ragged.
@vskip AMOUNT	LT	T{
Insert whitespace so as to push text on the remainder
of the page towards the bottom of the page.
T}
@w{TEXT}	F	Prevent TEXT from being split across two lines.
@page	LT	Start a new page in a printed manual.
@need N	LT	T{
Need N mils (start new page if necessary).
T}
@noindent	L	Prevent text from being indented as if it were a new paragraph.
.uh "Tables"
@itemize MARK	LE	Mark future `@item' with MARK.
@enumerate	LE	Begin a numbered list
@table COMMAND	L	Begin a two column table, using COMMAND for each entry.
@ftable COMMAND	LE	Begin a two-column table.
@item	L	Indicate the beginning of a marked paragraph
@itemx	L	Like `@item' but without extra vertical space.
@asis	L	Do not highlight first column of previous table.
.TE
.fi
.sp
.sz +3
.uh "Texinfo Mode"
.sz -3
.TS H
lfC l.
\fRCommand\fP	Description
.sp -6p
.hl
.TH
.sp -1
.uh "Insert Commands"
C-c C-c c	Insert `@code'.
C-c C-c d	Insert `@dfn'.
C-c C-c e	Insert `@end'.
C-c C-c i	Insert `@item'.
C-c C-c n	Insert `@node'.
C-c C-c s	Insert `@samp'.
C-c C-c v	Insert `@var'.
C-c C-c {	Insert braces.
C-c C-c }	Move out of enclosing braces.
.uh "Show Structure"
C-c C-s	List all the headings.
.uh "The Master Update Command
C-c C-u m	T{
Create or update a master menu.
With an argument, first create or update all nodes and regular menus.
T}
M-x texinfo-master-menu	\^
.uh "Update Pointers"
C-c C-u C-n	Update a node.
C-c C-u C-e	Update every node in the buffer.
.uh "Update Menus"
C-c C-u C-m	Make or update a menu.
C-c C-u C-a	T{
Make or update all the menus in a buffer;
with an argument, first update all the nodes.
T}
.uh "Format for Info (texinfo-format...)"
C-c C-e C-r	Format the region.
C-c C-e C-b	Format the buffer.
.uh "Format for Info (makeinfo)"
C-c C-m C-r	Format the region.
C-c C-m C-b	Format the buffer.
C-c C-m C-l	Recenter the `makeinfo' output buffer.
C-c C-m C-k	Kill the `makeinfo' formatting job.
.uh "Typeset and Print"
C-c C-t C-r	Run TeX on the region.
C-c C-t C-b	Run TeX on the buffer.
C-c C-t C-i	Run `texindex'.
C-c C-t C-p	Print the DVI file.
C-c C-t C-q	Show the print queue.
C-c C-t C-d	Delete a job from the print queue.
C-c C-t C-k	Kill the current TeX formatting job.
C-c C-t C-x	Quit a currently stopped TeX formatting job.
C-c C-t C-l	Recenter the output buffer.
.uh "Other Updating Commands"
M-x texinfo-insert-node-lines	T{
Insert missing node lines using section titles as node names.
T}
M-x texinfo-multiple-files-update	Update a multi-file document.
M-x texinfo-indent-menu-description	Indent descriptions.
M-x texinfo-sequential-node-update	Insert node pointers in strict sequence.
.TE
.uh Notes
.nf
L = This command begins a line		I = Affects only info
E = Command needs a matching @end	T = Affects only TeX
F = May be used as a function		H = This heading put into table of contents
.sp
Texinfo Reference Card, \*(Vl
.fi
By Trent A. Fisher (trent@cs.pdx.edu), taken from the
.i "Texinfo Manual"
by Robert Chassell and Richard Stallman.
