Re: PDF & single-sourcing history

Subject: Re: PDF & single-sourcing history
From: Laura Lemay <lemay -at- lauralemay -dot- com>
To: Sandy Harris <sandyinchina -at- gmail -dot- com>, Robert Lauriston <robert -at- lauriston -dot- com>
Date: Wed, 6 Mar 2013 09:54:50 -0800


Just as an additional point to what Sandy said, the "printed manuals" for man pages were typeset in that they were set in Times Roman and they had headings in a larger font. Each printed page was numbered per man page, and I think there may have been page footers, but there was no consistent numbering for the entire set, nor was there a TOC or index or anything of the things you would expect from an actual book. It was just a collection of printouts.

Some manufacturers also had more traditional task-based documentation, and that was also written in troff with custom macros for book production. I came into Unix documentation in 1989 right at the time my company was converting everything to FrameMaker, and there was a big fight from the older tech writers that WYSIWYG desktop publishing was *awful* because it didn't separate content from presentation, you couldn't tag your content for screen or print, or create conditions based on the different variations of the product. Irony.

Laura


On Mar 6, 2013, at 8:48 AM, Sandy Harris wrote:

> On Wed, Mar 6, 2013 at 11:26 AM, Robert Lauriston <robert -at- lauriston -dot- com> wrote:
>
>> Were man pages single-sourced? I always thought they were just files.
>> Did someone produce printed manuals, and if so, how?
>
> Yes. Some old DEC system (RT-11?) had a 'runoff' print command, so
> Unix got nroff(1) (new runoff) and troff(1) (typesetter runoff); man(1)
> pages were written and stored using the markup for those, with a
> manuals-specific macro package.
>
> The online stuff, which had to display on a dumb terminal with quite
> limited facilities, was generated with nroff and the printed manuals
> got better formatting via troff, but both came from the same source.
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> EPUB Webinar: Join STC Vice President Nicky Bleiel as she discusses tips for creating EPUB, the file format used for e-readers, tablets, smartphones, and more.
>
> Learn more: http://bit.ly/12LyN2z
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as lemay -at- lauralemay -dot- com -dot-
>
> To unsubscribe send a blank email to
> techwr-l-leave -at- lists -dot- techwr-l -dot- com
>
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
> http://www.techwhirl.com/email-discussion-groups/ for more resources and info.
>
> Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com
>
> Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
EPUB Webinar: Join STC Vice President Nicky Bleiel as she discusses tips for creating EPUB, the file format used for e-readers, tablets, smartphones, and more.

Learn more: http://bit.ly/12LyN2z

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


References:
Re: PDF & single-sourcing history: From: Sandy Harris
Re: PDF & single-sourcing history: From: Sandy Harris

Previous by Author: Hello
Next by Author: Re: starting a sentence w/lower-case product name
Previous by Thread: Re: PDF & single-sourcing history
Next by Thread: Re: PDF & single-sourcing history


What this post helpful? Share it with friends and colleagues:


Sponsored Ads