The Unix Heritage Society mailing list
 help / color / mirror / Atom feed
* [TUHS] Reconstructed and newly set UNIX Manual
@ 2018-10-26 19:46 Angelo Papenhoff
  2018-10-26 19:57 ` Jim Capp
                   ` (5 more replies)
  0 siblings, 6 replies; 23+ messages in thread
From: Angelo Papenhoff @ 2018-10-26 19:46 UTC (permalink / raw)
  To: tuhs

The last couple of days I worked on re-setting the V3-V6 manuals.
I reconstructed V5 from the scan as best I could, unfortunately some
pages were missing.
You can find everything I used to do this here,
please read the BUGS section:
https://github.com/aap/unixman

The results can be found here, as HTML and PDF:
http://squoze.net/UNIX/v3man/
http://squoze.net/UNIX/v4man/
http://squoze.net/UNIX/v5man/
http://squoze.net/UNIX/v6man/

Reconstructing V1 and V2 n?roff source and converting the tty 37 output
to ps is something I want to do too, but for now this was exhausting
enough. 

Now for the questions that I arose while I was doing this:
Are there scans of the V4 and V6 manual to check my pdfs against?
Where does the V5 manual come from? As explained in the README,
some pages are missing and some pages seem to be earlier than V4.
Is there another V5 manual that one could check against?
Why is lc (the LIL compiler) not in the TOC but has a page?

And most importantly: is the old troff really lost?
I would love to set the manual on the original systems
at some point (and write a CAT -> ps converter, which should be fun).
Doing all this work made me wish we still had earlier versions
of UNIX and its tools around.

Have fun with this!

aap

^ permalink raw reply	[flat|nested] 23+ messages in thread
* Re: [TUHS] Reconstructed and newly set UNIX Manual
@ 2018-10-27 11:59 Doug McIlroy
  2018-10-27 12:28 ` Angelo Papenhoff
  2018-10-27 15:53 ` Clem Cole
  0 siblings, 2 replies; 23+ messages in thread
From: Doug McIlroy @ 2018-10-27 11:59 UTC (permalink / raw)
  To: tuhs

 > Now it could be that v7 troff is perfectly capable of generating the
> manual just like older troff would have.

On taking over editorship for v7, I added some macros to the -man
package. I don't specifically recall making any incompatible
changes. If there were any, they'd most likely show up in
the title and synopsis and should be fixable by a minor tweak
to -man. I'm quite confident that there would be no problems
with troff proper.

Doug

^ permalink raw reply	[flat|nested] 23+ messages in thread
* Re: [TUHS] Reconstructed and newly set UNIX Manual
@ 2018-10-27 14:18 Nelson H. F. Beebe
  0 siblings, 0 replies; 23+ messages in thread
From: Nelson H. F. Beebe @ 2018-10-27 14:18 UTC (permalink / raw)
  To: tuhs

Angelo Papenhoff <aap@papnet.eu> writes about the conversion of
printer points to other units:

>> >From my experience in the world of prepress 723pts == 10in.
>>
>> Then Adobe unleashed PostScript on us and redefined the point
>> so that 72pt == 1in.
>>
>> Ibunaware of any other definitions of a point.

The most important other one is that used by the TeX typesetting
system: 72.27pt is one inch.  TeX calls the Adobe PostScript one a big
point: 72bp == 1in.  Here is what Don Knuth, TeX's author, wrote on
page 58 of The TeXbook (Addison-Wesley, 1986, ISBN 0-201-13447-0):

>> ...
>>     The units have been defined here so that precise conversion to sp
>>     is efficient on a wide variety of machines. In order to achieve
>>     this, TeX's ``pt'' has been made slightly larger than the official
>>     printer's point, which was defined to equal exactly .013837in by
>>     the American Typefounders Association in 1886 [cf. National Bureau
>>     of Standards Circular 570 (1956)]. In fact, one classical point is
>>     exactly .99999999pt, so the ``error'' is essentially one part in
>>     10^8.  This is more than two orders of magnitude less than the
>>     amount by which the inch itself changed during 1959, when it
>>     shrank to 2.54cm from its former value of (1/0.3937)cm; so there
>>     is no point in worrying about the difference. The new definition
>>     72.27pt=1in is not only better for calculation, it is also easier
>>     to remember.
>> ...

Here sp is a scaled point: 65536sp = 1pt.  The distance 1sp is smaller
than the wavelength of visible light, and is thus not visible to
humans.

TeX represents physical dimensions as integer numbers of scaled
points, or equivalently, fixed-point numbers in points, with a 16-bit
fraction.  With a 32-bit word size, that leaves 16 bits for the
integer part, of which the high-order bit is a sign, and the adjacent
bit is an overflow indicator.  That makes TeX's maximum dimension on
such machines 1sp below 2^14 (= 16,384) points, or about 5.75 meters
or 18.89 feet.

-------------------------------------------------------------------------------
- Nelson H. F. Beebe                    Tel: +1 801 581 5254                  -
- University of Utah                    FAX: +1 801 581 4148                  -
- Department of Mathematics, 110 LCB    Internet e-mail: beebe@math.utah.edu  -
- 155 S 1400 E RM 233                       beebe@acm.org  beebe@computer.org -
- Salt Lake City, UT 84112-0090, USA    URL: http://www.math.utah.edu/~beebe/ -
-------------------------------------------------------------------------------

^ permalink raw reply	[flat|nested] 23+ messages in thread

end of thread, other threads:[~2018-11-01 18:38 UTC | newest]

Thread overview: 23+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2018-10-26 19:46 [TUHS] Reconstructed and newly set UNIX Manual Angelo Papenhoff
2018-10-26 19:57 ` Jim Capp
2018-10-26 20:41 ` Clem Cole
2018-10-26 21:05   ` Angelo Papenhoff
2018-10-26 21:58     ` Bakul Shah
2018-10-26 20:59 ` Warren Toomey
2018-10-27 17:15   ` Angelo Papenhoff
2018-10-27 17:41     ` Angelo Papenhoff
     [not found] ` <20181026214308.GA20796@minnie.tuhs.org>
     [not found]   ` <20181026221153.GA19920@indra.papnet.eu>
2018-10-26 22:29     ` Angelo Papenhoff
2018-10-26 23:06       ` Warner Losh
2018-10-26 23:46         ` Larry McVoy
2018-10-28 22:57 ` Angelo Papenhoff
2018-10-29  0:15   ` Clem cole
2018-11-01 17:21 ` Angelo Papenhoff
2018-10-27 11:59 Doug McIlroy
2018-10-27 12:28 ` Angelo Papenhoff
2018-10-27 13:07   ` Milo Velimirovic
2018-10-27 13:56     ` Toby Thain
2018-10-27 15:19     ` Ralph Corderoy
2018-10-27 15:53 ` Clem Cole
2018-10-27 16:25   ` Larry McVoy
2018-10-27 19:45   ` Lars Brinkhoff
2018-10-27 14:18 Nelson H. F. Beebe

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).