Annotation of OpenXM_contrib/pari/doc/gphelp.1, Revision 1.1
1.1 ! maekawa 1: .TH GPHELP 1 "25 June 1999"
! 2: .SH NAME
! 3: gphelp \- GP-PARI online help script
! 4: .SH SYNOPSIS
! 5: .BR gphelp
! 6: [-to_pod
! 7: .IR file ]
! 8: [-raw]
! 9: [-detex]
! 10: [-k]
! 11: [-ch
! 12: .IR c1 ]
! 13: [-cb
! 14: .IR c2 ]
! 15: [-cu
! 16: .IR c3 ]
! 17: [keyword [ @{1,2,3,4,5} ]]
! 18: [tutorial]
! 19: [refcard]...
! 20: .SH COPYRIGHT
! 21: The PARI/GP package
! 22: is Copyright (C) 1989-1999 by C.Batut, K.Belabas, D.Bernardi, H.Cohen and
! 23: M.Olivier.
! 24:
! 25: .B gphelp
! 26: is free software.
! 27:
! 28: .SH DESCRIPTION
! 29: Invokes the PARI-GP online help script. By default,
! 30: .I keyword
! 31: is understood as a section heading (a GP function name), and
! 32: .B gphelp
! 33: looks for it in Chapter 3 of PARI User's Manual. If it is found, the
! 34: corresponding section is copied to a temporary file in /tmp (or .BR
! 35: $GPTMPDIR ),
! 36: .B TeX
! 37: is run then the corresponding section is displayed in a separate window, using
! 38: .B xdvi
! 39: (or
! 40: .BR $GPXDVI ).
! 41:
! 42:
! 43: If more than one keyword is given on a single command line, the outputs are
! 44: concatenated. If
! 45: .I keyword
! 46: is omitted, open the whole manual
! 47: .IR users.dvi .
! 48: The keywords
! 49: .I tutorial
! 50: and
! 51: .I refcard
! 52: open the GP tutorial and reference card respectively.
! 53:
! 54: GP defaults, help sections (1 to 11) as well as some keywords (readline,
! 55: bnf¸ ell, all operators...) are recognized and treated in a special way to
! 56: make sure they match a section heading. For instance
! 57: .B &&
! 58: is translated to
! 59: .I "Comparison and boolean operators"
! 60: which isn't that obvious to guess.
! 61: Make sure to enclose
! 62: .I keyword
! 63: between quotes if it contains dangerous characters (e.g spaces). For
! 64: instance, you need to type
! 65:
! 66: .RS
! 67: gphelp -k "elliptic curves"
! 68: .RE
! 69:
! 70: and not
! 71:
! 72: .RS
! 73: gphelp -k elliptic curves
! 74: .RE
! 75:
! 76: which would look for
! 77: "elliptic"
! 78: then for
! 79: "curves"
! 80: and output e.g.
! 81: .B ploth
! 82: among the relevant sections.
! 83:
! 84: .SH FULL SEARCH: @ MARKERS
! 85:
! 86: The pattern
! 87: .BR @ x
! 88: (where x is a chapter number between 1 and 5) at the end of
! 89: .I keyword
! 90: conducts the search in the corresponding chapter instead of the default
! 91: Chapter 3. If the number is omitted, search the whole manual. For instance
! 92: .RS
! 93: gphelp -k gerepile@4
! 94: .RE
! 95: will look for
! 96: .B gerepile
! 97: in Chapter 4 of users manual.
! 98: .RS
! 99: gphelp -k gerepile@
! 100: .RE
! 101: will search the whole manual. All chapters of the manual (usersch[1-5].tex)
! 102: are assumed to be in
! 103: .B $GPDOCDIR
! 104: .RI ( /usr/local/lib/pari
! 105: by default). You are allowed to gzip (or compress) them, this won't affect
! 106: the search.
! 107:
! 108: .SH OPTIONS
! 109: The following command line options are available:
! 110: .TP
! 111: .BI -cb,\ -color_bold\ c2
! 112: color used for bold. See
! 113: .BR -color_help .
! 114:
! 115: .TP
! 116: .BI -ch,\ -color_help\ c1
! 117: color (between 1 and 16) used for general printing. Only
! 118: significant in
! 119: .B detex
! 120: mode.
! 121:
! 122: .TP
! 123: .BI -cu,\ -color_underline\ c3
! 124: color used for underline. See
! 125: .BR -color_help .
! 126:
! 127: .TP
! 128: .BI \-detex
! 129: Use
! 130: .B detex
! 131: mode. The TeX file is converted to readable screen output that is directly
! 132: written to the terminal; don't use tex or xdvi.
! 133:
! 134: .TP
! 135: .BI \-k
! 136: Switch to
! 137: .B apropos
! 138: mode. Only write to standard output the list of section headings in manual
! 139: which contain
! 140: .IR keyword .
! 141:
! 142: You can then choose an element in the list and use it as argument for
! 143: .B gphelp
! 144: (surround it by quotes if it includes spaces), possibly followed by a
! 145: trailing
! 146: .B @
! 147: marker (see above).
! 148:
! 149: .TP
! 150: .BI \-raw
! 151: use internal format for output (using @x markers). For debugging only.
! 152:
! 153: .TP
! 154: .BI \-to_pod\ file
! 155: try to convert
! 156: .I file
! 157: from TeX to POD format. Will only work on some subset of PARI User's Manual
! 158: (Chapter 3, reference card). This should be the only arguments on the
! 159: command line.
! 160:
! 161: .SH ENVIRONMENT
! 162: .TP
! 163: COLUMNS
! 164: number of columns available on screen (for
! 165: .B detex
! 166: mode)
! 167:
! 168: .TP
! 169: DISPLAY
! 170: where to launch the dvi previewer. If unset,
! 171: .B detex
! 172: mode is assumed automatically.
! 173:
! 174: .TP
! 175: GPDOCDIR
! 176: directory where PARI help files are located,
! 177: .I /usr/local/lib/pari
! 178: by default.
! 179:
! 180: .TP
! 181: GPTMPDIR
! 182: directory where temporary files are written
! 183:
! 184: .TP
! 185: GPXDVI
! 186: .RS
! 187: dvi previewer to use
! 188: .RE
! 189:
! 190: .SH FILES
! 191: .TP
! 192: .I /usr/local/bin/gp
! 193: the gp calculator
! 194:
! 195: .I /usr/local/bin/gphelp
! 196: the gphelp script
! 197:
! 198: .TP
! 199: .I /usr/local/lib/pari/users.dvi
! 200: PARI/GP User's Manual
! 201:
! 202: .TP
! 203: .I /usr/local/lib/pari/tutorial.dvi
! 204: PARI/GP tutorial
! 205:
! 206: .TP
! 207: .I /usr/local/lib/pari/refcard.dvi
! 208: GP reference card
! 209:
! 210: .TP
! 211: .I /usr/local/lib/pari/refcard.ps
! 212: GP reference card, printer ready
! 213:
! 214: .SH BUGS
! 215:
! 216: The search algorithm is rather crude and the data searched rather
! 217: unstructured. Hence, searching outside of Chapter 3 may not yield useful
! 218: results, except in
! 219: .B apropos
! 220: mode (sections may be truncated too soon for instance).
! 221:
! 222: Multiword search patterns have a tendency to fail due to various TeX
! 223: constructs in the source.
! 224:
! 225: .SH AUTHORS
! 226: Originally written by Ilya Zakharevitch for the Math::Pari perl package.
! 227: Rewritten and expanded by Karim Belabas for the main PARI distribution.
! 228:
! 229: .SH SEE ALSO
! 230: .IR gp (1),
! 231: .IR gzip (1),
! 232: .IR readline (1),
! 233: .IR tex (1),
! 234: .IR xdvi (1).
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>