Skip to content

Commit a3fd341

Browse files
johnsonjhjohnsonjh
committed
Add 3rdparty/bigfoot: BIGFOOT 1.0, 7 January 1984
1 parent 8346406 commit a3fd341

File tree

3 files changed

+210
-0
lines changed

3 files changed

+210
-0
lines changed

‎3rdparty/bigfoot/bigfoot.com‎

16.8 KB
Binary file not shown.

‎3rdparty/bigfoot/bigfoot.mss‎

Lines changed: 179 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,179 @@
1+
@COMMENT<THIS FILE MUST BE FORMATTED USING PF.COM AND THEN
2+
PRINTED USING PP.COM>
3+
@STYLE<leftmargin 10 chars, paperlength 11 inches, indent 6 chars>
4+
@MESSAGE<FORMATTING FOR DEVICE TYPE 12? >
5+
@PAGEHEADING<left="BIGFOOT - footnoting program for PLU*PERFECT WRITER">
6+
@pagefooting(center=@value<page>)
7+
@style(spacing 1 line, spread 1 line)
8+
@style(chapters no)
9+
@begin(center)
10+
@u<BIGFOOT 1.0 (CP/M Version)>
11+
12+
USER'S GUIDE
13+
14+
by
15+
16+
Michael A. Covington
17+
18+
19+
Last revised 7 January 1984
20+
21+
22+
Athens Microcomputer Center
23+
2173 West Broad Street
24+
Athens, Georgia 30604
25+
@end(center)
26+
@begin(text)
27+
@section(Introduction)
28+
29+
BIGFOOT is a program that frees you from two of the most
30+
important limitations of Perfect Writer. In itself, Perfect
31+
Writer prohibits footnotes more than 300 characters long, and the
32+
entire set of footnotes cannot exceed the size of the Perfect
33+
Writer endspace (typically 5000 characters). BIGFOOT provides a
34+
way of getting around both of these restrictions, so that the
35+
lengths of individual footnotes and the total space occupied by
36+
footnotes is limited only by the disk space available.
37+
38+
BIGFOOT works by creating a rearranged copy of your document
39+
which you can then format and print with Perfect Writer in the
40+
usual way. BIGFOOT picks up all the footnotes -- marked with the
41+
@@NOTE command, just as if they were to be processed by Perfect
42+
Writer -- and places them in a numbered list either at the end of
43+
your document or in a separate file; at the original location of
44+
each footnote BIGFOOT places a command to print the appropriate
45+
superscript number.
46+
47+
Since the rearranging is done in a copy of your document rather
48+
than in the original, you can make revisions by editing the
49+
original and running it through BIGFOOT again. In this way you
50+
can add or remove footnotes -- or anything else -- and have the
51+
footnote numbering come out correct in the final version. You
52+
can also edit the rearranged copy in order to control the fine
53+
details of the format in which the footnotes are printed.
54+
55+
@section(A Note to Beginners)
56+
57+
The remainder of this manual presupposes that you are already
58+
familiar with Perfect Writer. If not, you should probably put
59+
BIGFOOT aside until you have had some practice using Perfect
60+
Writer by itself.
61+
62+
@section(Using BIGFOOT)
63+
64+
Your BIGFOOT disk is not copy-protected, and we strongly
65+
recommend that you make a copy of it to work with while storing
66+
the original in a safe place. In what follows, when we mention
67+
your BIGFOOT disk, we mean the working copy, not the original.
68+
69+
BIGFOOT accepts Perfect Writer document files with footnotes
70+
marked with @@NOTE (just as for Perfect Writer); the only
71+
difference is that, in a document to be processed by BIGFOOT, the
72+
footnotes can be of unlimited length.
73+
74+
To activate BIGFOOT, do the following:
75+
76+
(1) Use Perfect Writer to create and save the document that you
77+
want to process. Mark footnotes with @@NOTE (just as if they
78+
were to be processed by Perfect Formatter). With BIGFOOT, the
79+
footnotes can be of any length and are always placed in a
80+
numbered list at the end of the document or on a separate file,
81+
not at the foot of the page.
82+
83+
(2) If in Perfect Writer, exit to CP/M.
84+
85+
(3) Remove the Perfect Writer disk from drive A and insert the
86+
BIGFOOT disk. (Your document disk remains in drive B.) Type
87+
@ux(@w(A:BIGFOOT)).
88+
89+
(4) BIGFOOT asks you for the name of the file containing the
90+
original document and the name of the file onto which the
91+
rearranged document is to be written. (The file that is to be
92+
written does not have to exist already; BIGFOOT will create it.
93+
If, however, a file with the same name exists already, it will be
94+
overwritten.)
95+
96+
For safety, the name of the file that BIGFOOT is to create must
97+
end in '.BFT'; if necessary, BIGFOOT will change the file name
98+
that you type in order to ensure that this is so. On the other
99+
hand, the file name for the original document cannot end in
100+
'.BFT' (it usually ends in '.MSS').
101+
102+
(4) BIGFOOT asks you whether you want the footnotes included in
103+
the original file. If so, you are asked to indicate a disk drive
104+
on which BIGFOOT can use some temporary work space; Drive A
105+
(containing the BIGFOOT disk) is usually satisfactory. If you
106+
want the footnotes written on a separate file, BIGFOOT does not
107+
need work space and instead asks you to name the file on which
108+
the footnotes are to be written.
109+
110+
(5) BIGFOOT displays the numbers of the footnotes that are being
111+
processed (analogous to the page numbers displayed by Perfect
112+
Formatter and Perfect Printer). The run ends with a
113+
"Reformatting complete" message.
114+
115+
(6) The next step is to get back into Perfect Writer (by placing
116+
the Perfect Writer disk in drive A and typing MENU) and format
117+
and print the newly created file. For instance, if you had an
118+
original document named MYFILE.MSS and you've just created a
119+
rearranged version called MYFILE.BFT, you should ask Perfect
120+
Writer to format MYFILE.BFT (producing MYFILE.FIN) and then print
121+
MYFILE.FIN. (Careful here! If, after formatting MYFILE.BFT, you
122+
just hit RETURN when Perfect Writer asks you what file to print,
123+
Perfect Writer may want to print MYFILE.BFT, which is wrong; you
124+
want to print MYFILE.FIN.)
125+
126+
@section(Important Notes)
127+
128+
(1) Unlike Perfect Writer, BIGFOOT does not assume '.MSS' at the
129+
ends of file names for which the extension is not specified.
130+
With BIGFOOT, you must type the complete file name (preferably
131+
including drive).
132+
133+
(2) Note that neither BIGFOOT nor Perfect Writer accepts
134+
@@BEGIN(NOTE) or @@END(NOTE). @@BEGIN and @@END can be used only
135+
with environment format commands such as TEXT and FLUSHLEFT.
136+
137+
(3) Place the @@NOTE marker exactly where you want the footnote
138+
number to appear. Do not space before it unless you want a space
139+
before the footnote number.
140+
141+
(4) No matter how strange the output from BIGFOOT looks, try
142+
actually running it through the Perfect Writer formatter before
143+
concluding that there is anything wrong with it. Since BIGFOOT
144+
preserves all line breaks in the original and in addition
145+
introduces a line break at every footnote, the reformatted
146+
document will contain many lines that are shorter than the
147+
original.
148+
149+
(5) When you ask for footnotes to be included in the reformatted
150+
document, they are placed right at the end of it. Therefore,
151+
formatting commands intended to affect footnotes can be placed at
152+
the end of the original document; the footnotes will be placed
153+
after them.
154+
155+
@section(Error Messages)
156+
157+
@flushleft(@u<S-TYPE FILE NOT FOUND ERROR>)
158+
You have asked BIGFOOT to read a file that does not exist.
159+
Double-check the file name, including the drive specification.
160+
161+
@flushleft(@u<S-FILE WRITE ERROR>)
162+
BIGFOOT is unable to write on the disk that you have asked it to
163+
use. The disk may be full (use the STAT command to find out), or
164+
something else may be wrong (e.g., drive door not closed).
165+
166+
@flushleft(@u<READ PAST EOF ERROR>) Your original document file
167+
probably contains a footnote that never ends; that is, you have
168+
forgotten the closing bracket after an "@@NOTE(" or the like. If
169+
you are positive that this is not the problem, look for other
170+
abnormalities of format in your document.
171+
172+
@flushleft(@u<BDOS ERR ON X: SELECT>)
173+
You have asked BIGFOOT to use drive 'X', which does not exist or
174+
is inaccessible. Press RETURN to return to CP/M.
175+
@end(text)ed to affect footnotes can be placed at
176+
the end of the original document; the footnotes will be placed
177+
after them.
178+
179+
@

‎3rdparty/bigfoot/testdoc.mss‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
@style(spacing 2 lines)
2+
@begin(center)
3+
TEST DOCUMENT TO DEMONSTRATE
4+
THE VIRTUES OF BIGFOOT 1.0
5+
6+
Michael A. Covington
7+
1984
8+
@end(center)
9+
BIGFOOT 1.0@note{MS-DOS version copyright 1983 Michael A.
10+
Covington. CP/M version copyright 1984 Michael A. Covington.
11+
Available from Athens Microcomputer Center, Athens, Georgia.} is
12+
a computer program that frees you from two of the limitations of
13+
Perfect Writer. In Perfect Writer,@note{A product of Perfect
14+
Software, Berkeley, California. The author of BIGFOOT has no
15+
affiliation with the authors or publishers of Perfect Writer.} no
16+
footnote can be more than 300 characters long, and the total set
17+
of footnotes cannot be larger than the Perfect Writer endspace,
18+
typically 5000 characters.
19+
20+
BIGFOOT reformats Perfect Writer documents so that these
21+
restrictions do not apply. BIGFOOT works through the document,
22+
picks up all the passages markred @@NOTE(...),@note(Any of the
23+
standard Perfect Writer brackets or "fences" can be used to
24+
enclose the text of a footnote. Note that BIGFOOT always treats
25+
footnotes as endnotes, placing them at the end of the document.
26+
This, by the way, is a footnote too long for Perfect Writer to
27+
handle by itself, which is why this test document requires
28+
BIGFOOT.) replaces them by codes for superscript numbers, and
29+
places them in a numbered list at the end of the document or on a
30+
separate file.
31+


0 commit comments

Comments
 (0)