From owner-freebsd-doc Mon Dec 11 09:58:25 1995 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id JAA08390 for doc-outgoing; Mon, 11 Dec 1995 09:58:25 -0800 (PST) Received: from fslg8.fsl.noaa.gov (fslg8.fsl.noaa.gov [137.75.131.171]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id JAA08382 for ; Mon, 11 Dec 1995 09:58:22 -0800 (PST) Received: by fslg8.fsl.noaa.gov (5.57/Ultrix3.0-C) id AA16788; Mon, 11 Dec 95 11:58:21 -0600 Received: by emu.fsl.noaa.gov (1.38.193.4/SMI-4.1 (1.38.193.4)) id AA00551; Mon, 11 Dec 1995 10:58:20 -0700 Date: Mon, 11 Dec 1995 10:58:20 -0700 From: kelly@fsl.noaa.gov (Sean Kelly) Message-Id: <9512111758.AA00551@emu.fsl.noaa.gov> To: jfieber@indiana.edu Cc: doc@freebsd.org In-Reply-To: (message from John Fieber on Fri, 8 Dec 1995 21:14:12 -0500 (EST)) Subject: Re: Time to do more writing Sender: owner-doc@freebsd.org Precedence: bulk >>>>> "John" == John Fieber writes: John> On Fri, 8 Dec 1995, Sean Kelly wrote: >> It looks like the FreeBSD Handbook's part on Network >> Communication's chapter on Basic Networking's section on >> Hardwired Terminals in unwritten and unclaimed. John> The organization is a total mess. I've got a few pieces John> pieces that were submitted some time ago that should go in, John> but the organization needs to be ironed out first. John> If you have a good plan, post an outline here! Here's an outline, but I have no idea if it's good: PART x: NETWORKING Network terminology Setting up your hosts Standalone systems Hostnames, domain names, IP addresses ISPs and NAPs The NIC Attached versus detached networks Planning for the future Configuring network hardware and software Ethernet adapters Synchronous adapters Parallel ports for PLIP Serial ports Terminals Modems for dial-in users PPP SLIP UUCP ISDN ATM Loopback devices Assigning addresses Routing Testing your setup Installing network services Hostname/address translation Configuring the resolver: /etc/resolv.conf and /etc/host.conf Configuring DNS Becoming a primary DNS server Secondary servers Caching servers Administrating inetd Setting up an FTP server Authenticated service Anonymous service Setting up an HTTP server Public domain servers Commercial servers CGI Setting up email services Mail client programs Sendmail biff Exporting filesystems with NFS Providing logins Via the network Via hardwired terminals Dial-up connections Providing access to printers Providing access to tape drives Synchronizing systems' times: xntp Becoming a PPP server Becoming a SLIP server RPC and the portmapper Advanced Network Services Custom services /etc/inetd /etc/services /etc/rpc and the RPC portmapper Network security Kerberos Secure RPC and Secure NFS Serving diskless clients and X terminals Client setup Server setup TFTP BOOTP rarpd Routing and bridging USENET Using the network Exploring the World Wide Web Sending and receiving email Email addresses Mailer programs Metamail standards Reading network news Transferring files FTP rcp NFS Getting user information finger rwho rusers Logging into remote hosts telnet rlogin Dial-up services Executing remote commands rsh and rexec Using rpcgen and RPC Programming Internet applications From owner-freebsd-doc Thu Dec 14 07:27:57 1995 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id HAA07923 for doc-outgoing; Thu, 14 Dec 1995 07:27:57 -0800 (PST) Received: from zappa.cs.uncc.edu (zappa.cs.uncc.edu [152.15.35.2]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id HAA07917 for ; Thu, 14 Dec 1995 07:27:52 -0800 (PST) From: jlrobins@zappa.cs.uncc.edu Received: by zappa.cs.uncc.edu (5.x/SMI-SVR4) id AA02036; Thu, 14 Dec 1995 10:18:51 -0500 Message-Id: <9512141518.AA02036@zappa.cs.uncc.edu> Subject: Wrong mirror site listed in USA. To: doc@freebsd.org Date: Thu, 14 Dec 1995 10:18:51 -0500 (EST) X-Mailer: ELM [version 2.4 PL24] Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-doc@freebsd.org Precedence: bulk ftp.cybernetics.net does not exist anymore. The ISP was bought out and cannibalized (well, that's mabye too strong of a word, even when misspelled), hence the machine does not exist. ftp://ftp.cs.uncc.edu/pub/FreeBSD/ will get you farther. James From owner-freebsd-doc Thu Dec 14 09:17:33 1995 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id JAA16746 for doc-outgoing; Thu, 14 Dec 1995 09:17:33 -0800 (PST) Received: from freebsd.netcom.com (freebsd.netcom.com [198.211.79.3]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id JAA16732 for ; Thu, 14 Dec 1995 09:17:30 -0800 (PST) Received: (from bugs@localhost) by freebsd.netcom.com (8.6.12/8.6.12) id LAA00318 for freebsd-doc@freebsd.org; Thu, 14 Dec 1995 11:14:13 -0600 From: Mark Hittinger Message-Id: <199512141714.LAA00318@freebsd.netcom.com> Subject: lets doc frequently fallen into traps #1 To: freebsd-doc@freebsd.org Date: Thu, 14 Dec 1995 11:14:13 -0600 (CST) X-Mailer: ELM [version 2.4 PL24 ME8b] Content-Type: text Sender: owner-doc@freebsd.org Precedence: bulk Frequently fallen into trap #1 New Freebsd user installs Freebsd without the 'secure' ware. The new user populates the password file with md5 hashes. Then the user realizes they wanted 'des' and loads 'secure'. Now passwords don't work. We can document how to unwind this with a stand alone boot. I have walked several new people through this process. One too many today :-) Regards, Mark Hittinger Netcom/Dallas bugs@freebsd.netcom.com From owner-freebsd-doc Thu Dec 14 09:22:40 1995 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id JAA17234 for doc-outgoing; Thu, 14 Dec 1995 09:22:40 -0800 (PST) Received: from freebsd.netcom.com (freebsd.netcom.com [198.211.79.3]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id JAA17229 for ; Thu, 14 Dec 1995 09:22:37 -0800 (PST) Received: (from bugs@localhost) by freebsd.netcom.com (8.6.12/8.6.12) id LAA00337 for freebsd-doc@freebsd.org; Thu, 14 Dec 1995 11:19:21 -0600 From: Mark Hittinger Message-Id: <199512141719.LAA00337@freebsd.netcom.com> Subject: lets doc frequently fallen into trap #2 To: freebsd-doc@freebsd.org Date: Thu, 14 Dec 1995 11:19:20 -0600 (CST) X-Mailer: ELM [version 2.4 PL24 ME8b] Content-Type: text Sender: owner-doc@freebsd.org Precedence: bulk Frequently fallen into trap #2 New user of FreeBSD experiments with the Linux emulation package. The new user copies the Linux shared libraries 'lib*.so.4' into /usr/lib. The new user happily plays with Linux binaries. Then one horrible day comes when they reboot and try to compile something on FreeBSD natively. Much evil then transpires. The telltale sign are link errors involving the crt0 module. Again, I've walked people out of this trap one too many times :-) The solution is to get rid of the 'lib*.so.4' files in /usr/lib and make them reboot (if they can!!). Then put the linux shared libraries in some other spot (like /usr/linux/lib). Regards, Mark Hittinger Netcom/Dallas bugs@freebsd.netcom.com From owner-freebsd-doc Thu Dec 14 11:44:55 1995 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id LAA03253 for doc-outgoing; Thu, 14 Dec 1995 11:44:55 -0800 (PST) Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id LAA03246 for ; Thu, 14 Dec 1995 11:44:50 -0800 (PST) Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.12/8.6.12) id OAA02406; Thu, 14 Dec 1995 14:44:46 -0500 Date: Thu, 14 Dec 1995 14:44:45 -0500 (EST) From: John Fieber X-Sender: jfieber@fieber-john.campusview.indiana.edu To: jlrobins@zappa.cs.uncc.edu cc: doc@FreeBSD.ORG Subject: Re: Wrong mirror site listed in USA. In-Reply-To: <9512141518.AA02036@zappa.cs.uncc.edu> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@FreeBSD.ORG Precedence: bulk On Thu, 14 Dec 1995 jlrobins@zappa.cs.uncc.edu wrote: > ftp.cybernetics.net does not exist anymore. Removed. > ftp://ftp.cs.uncc.edu/pub/FreeBSD/ will get you farther. Added. -john == jfieber@indiana.edu =========================================== == http://fieber-john.campusview.indiana.edu/~jfieber ============ From owner-freebsd-doc Thu Dec 14 14:42:08 1995 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id OAA23395 for doc-outgoing; Thu, 14 Dec 1995 14:42:08 -0800 (PST) Received: from grunt.grondar.za (grunt.grondar.za [196.7.18.129]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id OAA23386 for ; Thu, 14 Dec 1995 14:41:55 -0800 (PST) Received: from grumble.grondar.za (root@grumble.grondar.za [196.7.18.130]) by grunt.grondar.za (8.6.12/8.6.9) with ESMTP id AAA02799; Fri, 15 Dec 1995 00:41:37 +0200 Received: from localhost (mark@localhost [127.0.0.1]) by grumble.grondar.za (8.6.12/8.6.9) with SMTP id AAA03994; Fri, 15 Dec 1995 00:41:34 +0200 Message-Id: <199512142241.AAA03994@grumble.grondar.za> X-Authentication-Warning: grumble.grondar.za: Host localhost didn't use HELO protocol To: Mark Hittinger cc: freebsd-doc@freebsd.org Subject: Re: lets doc frequently fallen into traps #1 Date: Fri, 15 Dec 1995 00:41:33 +0200 From: Mark Murray Sender: owner-doc@freebsd.org Precedence: bulk Mark Hittinger wrote: > New Freebsd user installs Freebsd without the 'secure' ware. The new user > populates the password file with md5 hashes. Then the user realizes they > wanted 'des' and loads 'secure'. Now passwords don't work. > > We can document how to unwind this with a stand alone boot. I have walked > several new people through this process. One too many today :-) In the next coouple of days I will commit code that fixes this. Dual-Personality Crypt can pick up what salt was used ("$1$" for MD5) and will automatically use the same crypt (DES or MD5) M -- Mark Murray 46 Harvey Rd, Claremont, Cape Town 7700, South Africa +27 21 61-3768 GMT+0200 Finger mark@grondar.za for PGP key From owner-freebsd-doc Thu Dec 14 15:57:47 1995 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id PAA02025 for doc-outgoing; Thu, 14 Dec 1995 15:57:47 -0800 (PST) Received: from euclid.skiles.gatech.edu (euclid.skiles.gatech.edu [130.207.146.50]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id PAA01994 for ; Thu, 14 Dec 1995 15:57:16 -0800 (PST) Received: from redwood.skiles.gatech.edu (root@redwood.skiles.gatech.edu [130.207.146.12]) by euclid.skiles.gatech.edu (8.7.3/8.7.3) with ESMTP id SAA15658 for ; Thu, 14 Dec 1995 18:56:49 -0500 (EST) Received: from redwood.skiles.gatech.edu (coleman@localhost [127.0.0.1]) by redwood.skiles.gatech.edu (8.7.3/8.7.3) with ESMTP id SAA08801 for ; Thu, 14 Dec 1995 18:52:40 -0500 (EST) Message-Id: <199512142352.SAA08801@redwood.skiles.gatech.edu> X-Mailer: exmh version 1.6.5 12/11/95 To: doc@freebsd.org Subject: SGML tools for documentation Mime-Version: 1.0 Content-Type: text/plain Date: Thu, 14 Dec 1995 18:52:39 -0500 From: Richard Coleman Sender: owner-doc@freebsd.org Precedence: bulk Hi, I'm looking around at the various options for documentation for the free software project `zsh'. So far, we've just used man pages, but we would like to swith to something that would allow us to translate the base documentation into multiple formats. I understand that the FreeBSD project is now using some SGML tools for it's documentation. Is that correct?. It that how the FreeBSD Handbook is being done? If this is true, I would like to find out more info about what tools you use. If possible, I would like to acquire copies of these tools. Thanks, Also, I must say that FreeBSD 2.1 is way cool! Keep up the good work guys. Richard Coleman coleman@math.gatech.edu From owner-freebsd-doc Thu Dec 14 19:41:39 1995 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id TAA18472 for doc-outgoing; Thu, 14 Dec 1995 19:41:39 -0800 (PST) Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id TAA18467 for ; Thu, 14 Dec 1995 19:41:36 -0800 (PST) Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.12/8.6.12) id WAA06220; Thu, 14 Dec 1995 22:41:09 -0500 Date: Thu, 14 Dec 1995 22:41:09 -0500 (EST) From: John Fieber X-Sender: jfieber@fieber-john.campusview.indiana.edu To: Mark Murray cc: Mark Hittinger , freebsd-doc@freebsd.org Subject: Re: lets doc frequently fallen into traps #1 In-Reply-To: <199512142241.AAA03994@grumble.grondar.za> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@freebsd.org Precedence: bulk On Fri, 15 Dec 1995, Mark Murray wrote: > In the next coouple of days I will commit code that fixes this. > Dual-Personality Crypt can pick up what salt was used ("$1$" for MD5) > and will automatically use the same crypt (DES or MD5) It still needs to be documented for 2.1. -john == jfieber@indiana.edu =========================================== == http://fieber-john.campusview.indiana.edu/~jfieber ============ From owner-freebsd-doc Thu Dec 14 20:05:49 1995 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id UAA19706 for doc-outgoing; Thu, 14 Dec 1995 20:05:49 -0800 (PST) Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id UAA19700 for ; Thu, 14 Dec 1995 20:05:45 -0800 (PST) Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.12/8.6.12) id XAA06265; Thu, 14 Dec 1995 23:05:41 -0500 Date: Thu, 14 Dec 1995 23:05:40 -0500 (EST) From: John Fieber X-Sender: jfieber@fieber-john.campusview.indiana.edu To: Richard Coleman cc: doc@freebsd.org Subject: Re: SGML tools for documentation In-Reply-To: <199512142352.SAA08801@redwood.skiles.gatech.edu> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@freebsd.org Precedence: bulk On Thu, 14 Dec 1995, Richard Coleman wrote: > pages, but we would like to swith to something that would allow > us to translate the base documentation into multiple formats. > I understand that the FreeBSD project is now using some SGML > tools for it's documentation. Is that correct?. It that > how the FreeBSD Handbook is being done? If this is true, I > would like to find out more info about what tools you use. > If possible, I would like to acquire copies of these tools. If you have FreeBSD 2.1, you have all the tools. :) An SGML document has three parts: 1 An SGML declaration (/usr/share/sgml/FreeBSD/dtd/linuxdoc.dec) that describes a bunch of esoteric stuff about how an SGML tool should deal with the document. It defines things like what characters are used as tag delimiters (<, >, inside a ). The tags delimit elements. Elements are just containers that can hold text (#PCDATA) or other elements. The definition of what a particular element can contain is called the content model. The DTD used for the handbook is /usr/share/sgml/FreeBSD/dtd/linuxdoc. 3 A document instance. The SGML declaration is of little concern to you. The DTD is **critical**. Having worked with the linuxdoc DTD for a while, would advise against using it. I'm looking at moving the handbook to either the DocBook DTD, or the OSF book DTD. As far as processing tools, you need an SGML parser which is included with FreeBSD (sgmls). This digests chews up the document and spits out the document in a form that is trivial to parse with a program which will (hopefully) do something intelligent. There is a companion to sgmls, sgmlsasp, which will map sgml tags to whatever you want. This is a very primitive way of dealing with the conversion and has been a great limitation on what I have been able to do with the handbook. I have a tool called instant that came with the OSF DTD that is much more powerful, but has a lot of rough edges. Ultimately a tool that implements DSSSL, a companion standard to SGML, will address most of the issues/problems of rendering SGML documents. In the meantime, unless you fork out some large piles of money for commercial products, we are stuck with less than optimal tools. -john == jfieber@indiana.edu =========================================== == http://fieber-john.campusview.indiana.edu/~jfieber ============ From owner-freebsd-doc Thu Dec 14 21:09:04 1995 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id VAA23465 for doc-outgoing; Thu, 14 Dec 1995 21:09:04 -0800 (PST) Received: from jhome.DIALix.COM (root@jhome.DIALix.COM [192.203.228.69]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id VAA23454 for ; Thu, 14 Dec 1995 21:08:55 -0800 (PST) Received: (from julian@localhost) by jhome.DIALix.COM (8.7.3/8.7.3) id NAA02461 for doc@freebsd.org; Fri, 15 Dec 1995 13:08:43 +0800 (WST) From: Julian Elischer Message-Id: <199512150508.NAA02461@jhome.DIALix.COM> Subject: Re: Did the troff to HTML c (fwd) To: doc@freebsd.org Date: Fri, 15 Dec 1995 13:08:42 +0800 (WST) X-Mailer: ELM [version 2.4 PL24 ME8b] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-doc@freebsd.org Precedence: bulk maybe we can use this to keep our man-pages on the www page up-to-date. --forwrded message..-- The troff to html translation is marginal. I was able to translate the first page of an ms document. I could translate the first page of a man document as well. Another document translated completely. The quality of the translation is mediocre. Paragraphs are run together. Try file://~/.html/cvs.html to see cvs(5) man page after the translation. This was the best transation I received. The program is called troff2html. It is in /tools unsupported/bin. It is a perl program. The complete source is in /net/opshub/export/unsupported/src/troff2html. I'll let someone else work further with the translation, if anyone desires. Try running with the "-man" or "-ms" macros. Here is the README file. A Troff to HTML Converter ========================= I have used troff (and -ms macros) for many years and wanted to be able to convert my source documents into html format. I couldn't find a troff converter but did try a couple of converters for the -ms macros. I found that these often translated things different to the way I wanted them handled and that they had poor support for the troff features I often use, such as source file includes and font changes. Therefore I decided on a two-stage process: troff2html ========== This translates raw troff into html. Troff escapes are handled internally but troff requests are translated into sequences of perl commands in a control file (troff.req). This control file is easily edited to change the behaviour of requests or to add new ones, i.e. those I haven't dealt with. ms.pl ===== This translates the -ms macros into html. It maintains an html state stack. The -ms macros are represented as sequences of perl commands in a control file (troff.ms). Once again, this control file is easily edited. mv.pl ===== This translates the -mv macros into html (see control file troff.mv). man.pl ====== This translates the -man macros into html (see control file troff.man). And Finally =========== The result of this is an extremely adaptable package. Additional macro packages, e.g. -me macros, are easily added with their own control file. Preprocessors, like refer, can be used with the troff source because their output is recognised. Personal macros can also be added easily. Where are they? =============== A compressed tar archive of version 1.0 can be found at URL http://web.dcs.bbk.ac.uk/~mick/html Mick Farmer -- Kevin Dalley dalley@tfs.com ----- End of forwarded message from dalley@desrv.tfs.com ----- From owner-freebsd-doc Fri Dec 15 07:46:35 1995 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id HAA28461 for doc-outgoing; Fri, 15 Dec 1995 07:46:35 -0800 (PST) Received: from spot.lodgenet.com (lodgenet.iw.net [204.157.148.88]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id HAA28443 for ; Fri, 15 Dec 1995 07:46:29 -0800 (PST) Received: from jake.lodgenet.com (jake.lodgenet.com [204.124.120.30]) by spot.lodgenet.com (8.6.12/8.6.12) with ESMTP id JAA29816; Fri, 15 Dec 1995 09:46:12 -0600 Received: from localhost (localhost [127.0.0.1]) by jake.lodgenet.com (8.6.12/8.6.12) with SMTP id KAA08659; Fri, 15 Dec 1995 10:16:49 -0600 Message-Id: <199512151616.KAA08659@jake.lodgenet.com> X-Authentication-Warning: jake.lodgenet.com: Host localhost didn't use HELO protocol X-Mailer: exmh version 1.6.2 7/18/95 To: Julian Elischer cc: doc@freebsd.org Subject: Re: Did the troff to HTML c (fwd) In-reply-to: Your message of "Fri, 15 Dec 1995 13:08:42 +0800." <199512150508.NAA02461@jhome.DIALix.COM> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Date: Fri, 15 Dec 1995 10:16:48 -0600 From: "Eric L. Hernes" Sender: owner-doc@freebsd.org Precedence: bulk I've got perl script that I hacked out of plexus that does a pretty fair job of translating man pages to html on the fly. It even cross references #include files from sections 2 and 3. I'm using it to serve man pages for FreeBSD, linux, SCO, perl, tcl, and X11. Its pretty ugly right now, but it is functional. If anyone is interested, I can send a copy. eric. Julian Elischer writes: >maybe we can use this to keep our man-pages on the www page up-to-date. > >--forwrded message..-- > > > >The troff to html translation is marginal. I was able to translate >the first page of an ms document. I could translate the first page of >a man document as well. Another document translated completely. > >The quality of the translation is mediocre. Paragraphs are run >together. Try > > file://~/.html/cvs.html > >to see cvs(5) man page after the translation. This was the best >transation I received. > >The program is called troff2html. It is in /tools unsupported/bin. >It is a perl program. The complete source is in >/net/opshub/export/unsupported/src/troff2html. I'll let someone else >work further with the translation, if anyone desires. Try running >with the "-man" or "-ms" macros. Here is the README file. > >A Troff to HTML Converter >========================= > >I have used troff (and -ms macros) for many years and wanted >to be able to convert my source documents into html format. > >I couldn't find a troff converter but did try a couple of >converters for the -ms macros. I found that these often >translated things different to the way I wanted them handled >and that they had poor support for the troff features I >often use, such as source file includes and font changes. > >Therefore I decided on a two-stage process: > >troff2html >========== > >This translates raw troff into html. Troff escapes are >handled internally but troff requests are translated into >sequences of perl commands in a control file (troff.req). >This control file is easily edited to change the behaviour >of requests or to add new ones, i.e. those I haven't dealt >with. > >ms.pl >===== > >This translates the -ms macros into html. It maintains an >html state stack. The -ms macros are represented as >sequences of perl commands in a control file (troff.ms). >Once again, this control file is easily edited. > >mv.pl >===== > >This translates the -mv macros into html (see control file >troff.mv). > >man.pl >====== > >This translates the -man macros into html (see control file >troff.man). > >And Finally >=========== > >The result of this is an extremely adaptable package. >Additional macro packages, e.g. -me macros, are easily added >with their own control file. > >Preprocessors, like refer, can be used with the troff source >because their output is recognised. > >Personal macros can also be added easily. > >Where are they? >=============== > >A compressed tar archive of version 1.0 can be found at URL >http://web.dcs.bbk.ac.uk/~mick/html > >Mick Farmer >-- >Kevin Dalley >dalley@tfs.com > >----- End of forwarded message from dalley@desrv.tfs.com ----- -- erich@lodgenet.com erich@rrnet.com From owner-freebsd-doc Sat Dec 16 16:42:21 1995 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id QAA14153 for doc-outgoing; Sat, 16 Dec 1995 16:42:21 -0800 (PST) Received: from sagi.ucv.edu.ve (root@[150.185.84.230]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id QAA14148 for ; Sat, 16 Dec 1995 16:42:10 -0800 (PST) From: opereira@sagi.ucv.edu.ve Received: (from opereira@localhost) by sagi.ucv.edu.ve (8.6.9/8.6.9) id VAA06851; Sat, 16 Dec 1995 21:25:14 -0400 Date: Sat, 16 Dec 1995 21:25:14 -0400 Message-Id: <199512170125.VAA06851@sagi.ucv.edu.ve> To: doc@freebsd.org X-Mailer: Lynx, Version 2.3 BETA X-Personal_name: Orlando Pereira Sender: owner-doc@freebsd.org Precedence: bulk Hello, Can you help me.. Inedd handbook the Freebsd..may i have the handbook, send me..please!! thanks..!!