~ubuntu-branches/debian/lenny/fpc/lenny

« back to all changes in this revision

Viewing changes to man/man1/ptop.1

  • Committer: Bazaar Package Importer
  • Author(s): Mazen Neifer, Torsten Werner, Mazen Neifer
  • Date: 2008-05-17 17:12:11 UTC
  • mfrom: (3.1.9 intrepid)
  • Revision ID: james.westby@ubuntu.com-20080517171211-9qi33xhd9evfa0kg
Tags: 2.2.0-dfsg1-9
[ Torsten Werner ]
* Add Mazen Neifer to Uploaders field.

[ Mazen Neifer ]
* Moved FPC sources into a version dependent directory from /usr/share/fpcsrc
  to /usr/share/fpcsrc/${FPCVERSION}. This allow installing more than on FPC
  release.
* Fixed far call issue in compiler preventing building huge binearies.
  (closes: #477743)
* Updated building dependencies, recomennded and suggested packages.
* Moved fppkg to fp-utils as it is just a helper tool and is not required by
  compiler.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH ptop 1 "30 may 1999" "Free Pascal" "ptop source beautifier"
2
 
.SH NAME
3
 
ptop \- The FPC Pascal configurable source beautifier.
4
 
 
5
 
Origin probably Pascal\-TO\-Pascal.
6
 
 
7
 
.SH SYNOPSIS
8
 
 
9
 
.BI ptop "[-v] [-i indent] [-b bufsize ][-c optsfile] infile outfile"
10
 
 
11
 
.SH Description
12
 
 
13
 
.B ptop
14
 
is a more or less configurable 
15
 
.I "source beautifier"
16
 
for pascal sources, and specially the ones supported by FPC (which are 
17
 
more or less Turbo Pascal or Delphi 2.0 compatible).
18
 
.PP
19
 
ptop belongs to the 
20
 
.I "FPC utils"
21
 
package, which currently also contains 
22
 
.B ppdep
23
 
24
 
.B h2pas
25
 
26
 
.B ppudump
27
 
and 
28
 
.B ppumove
29
 
\.
30
 
 
31
 
.SH Usage
32
 
 
33
 
.B ptop 
34
 
basically reformats "infile" and outputs the result to "outfile". 
35
 
ituses a configuration file explained further below, and can generate a default
36
 
configurationfile for you to edit. (not needed if you use the defaults)
37
 
 
38
 
.SH Options
39
 
.TP
40
 
.B \-h
41
 
Writes a short description of these switches.
42
 
.TP
43
 
.B \-c
44
 
read options from configuration file. A configuration file is not needed, ptop
45
 
will revert to internal defaults then. See also \-g
46
 
.TP
47
 
.BI \-i " ident"
48
 
Sets the number of indent spaces used for BEGIN END; and other blocks.
49
 
.TP
50
 
.BI \-b " bufsize"
51
 
Sets the buffersize to bufsize. Default 255, 0 is considered non\-valid and ignored.
52
 
.TP
53
 
.B \-v
54
 
be verbose. Currently only outputs the number of lines read/written and some error messages.
55
 
.TP 
56
 
.BI \-g " ptop.cfg"
57
 
Writes a default configuration file to be edited to the file 
58
 
.I ptop.cfg
59
 
 
60
 
.PP
61
 
Try to play with ptop and its configfile until you find the effect you desire. The
62
 
configurability and possibilities of ptop are quite large compared to shareware
63
 
source beautifier found on e.g. SIMTEL.
64
 
.PP
65
 
 
66
 
.SH Acknowledgements
67
 
 
68
 
The writer of the program, Michael van Canneyt, who also helped out explaining
69
 
the format of ptop.cfg.
70
 
.PP
71
 
Questions/corrections can be mailed to fpc\-devel@vekoll.saturnus.vein.hu
72
 
.PP
73
 
Also thanks to the rest of the FPC development team.
74
 
 
75
 
The program is a modernized (OOP, Streams, Delphi extensions) version based on a
76
 
program by Peter Grogono, who in turn based his program on a Pascal pretty-printer written by Ledgard,
77
 
Hueras, and Singer.  See SIGPLAN Notices, Vol. 12, No. 7, July 1977,
78
 
pages 101-105, and PP.DOC/HLP.
79
 
.BR
80
 
This version of PP developed under Pascal/Z V4.0 or later.
81
 
Very minor modifications for Turbo Pascal made by Willett Kempton
82
 
March 1984 and Oct 84.  Runs under 8-bit Turbo or 16-bit Turbo.
83
 
Toad Hall tweak, rewrite for TP 5, 28 Nov 89
84
 
 
85
 
 
86
 
.SH SEE ALSO
87
 
.IP "ptop config file"
88
 
.BR ptop.cfg (5)
89
 
.IP "Compiler"
90
 
.BR  ppc386 (1)
91
 
.IP "Other FPC utils"
92
 
.BR  ppdep (1)
93
 
.BR  ppudump (1)
94
 
.BR  ppumove (1)
95
 
.BR  h2pas (1)