TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: man Pages From:John Posada <posada -at- FAXSAV -dot- COM> Date:Fri, 23 Jan 1998 17:33:45 -0500
Chris...the part that worries me is that I recall seeing hyperlinks in some man pages that appeared on the screen in reverse video. How do I create that effect and how to I create the hyperlink? Was I imagining something?
John
>Hey, guys...
>
>The time has come for me to figure out how to create set of UNIX man =
>pages.
>
>Unfortunately, I don't know where to even start.
I did man pages for UNIX: I wrote them in MS Word on the PC platform --
saved them to .txt. I then filtered them to from DOS to UNIX.<<<<<
Are there specifics such as line length or is that taken care of when its run through the UNIX text editor. I also assume that when I open and save in vi, that the PC end of line/end of file will convert to the appropriate UNIX end of line/end of file characters ?
>>>>>I checked the files via XEDIT -- VI is fine too -- to make sure the
translation was ok. Your UNIX guru *should* know that ASCII/text files
need to run through a filter for proper used [on both sides of the
platform].
My main thought in the exercise was to keep the files in a format where I
could edit/spell check easy.
You should check with the UNIX guru for name specifications of your files.
The program will "look" for the file in a specific location.
[I used "Exodus" as my UNIX gateway.]<<<<<
I use CuteFTP for my FTPing
>>>>>However, you can ftp the files in and do the same.
It was easier than using VI and hoping the spelling gawds were nice.
John Posada, Technical Writer (and proud of the title)
The world's premier Internet fax service company: The FaxSav Global Network
-work http://www.faxsav.com -personal http://www.tdandw.com
-work mailto:posada -at- faxsav -dot- com -personal mailto:john -at- tdandw -dot- com
-work phone: 732-906-2000 X2296 -home phone: 732-291-7811
My opinions are mine, and neither you nor my company can take credit for them.
HEY! Are you coming to the NJ TechWriter lunch? So far, about 10
of us are. Ask me about it.