From owner-freebsd-doc  Sat Aug  3 14:02:00 1996
Return-Path: owner-doc
Received: (from root@localhost)
          by freefall.freebsd.org (8.7.5/8.7.3) id OAA14777
          for doc-outgoing; Sat, 3 Aug 1996 14:02:00 -0700 (PDT)
Received: from frmug.org (frmug-gw.frmug.org [193.56.58.252])
          by freefall.freebsd.org (8.7.5/8.7.3) with SMTP id OAA14771
          for <doc@FreeBSD.org>; Sat, 3 Aug 1996 14:01:56 -0700 (PDT)
Received: (from uucp@localhost) by frmug.org (8.6.8/8.6.9) with UUCP id XAA22926 for doc@FreeBSD.org; Sat, 3 Aug 1996 23:01:19 +0200
Received: from localhost (localhost [127.0.0.1]) by xp11.frmug.org (8.7.5/8.7.3/xp11-uucp-1.1) with ESMTP id OAA01618 for <doc@FreeBSD.org>; Sat, 3 Aug 1996 14:15:24 +0200 (MET DST)
Message-Id: <199608031215.OAA01618@xp11.frmug.org>
To: doc@FreeBSD.org
Subject: parsing warnings
Date: Sat, 03 Aug 1996 14:15:23 +0200
From: "Philippe Charnier" <charnier@xp11.frmug.org>
Sender: owner-doc@FreeBSD.org
X-Loop: FreeBSD.org
Precedence: bulk

Hi,

When making the Faq, I get warnings:

sgmlfmt -f ascii  /usr/src/share/doc/FAQ/freebsd-faq.sgml
generating freebsd-faq.ascii...
<standard input>:2782: warning: `make' not defined
<standard input>:2891: warning: `xconsole'' not defined
<standard input>:4718: warning: escape character ignored before `@'

The first two warnings are due to lines beginning with ' symbol in the
nroff document. In fact this should be errors because the output file
(freebsd-faq.ascii) is truncated (didn't check html output).

Note that this also apply to handbook, I didn't checked yet, but hope to
send you patches tomorrow.

cvs diff: Diffing .
Index: freebsd-faq.sgml
===================================================================
RCS file: /home2h/FreeBSD.cvsroot/src/share/doc/FAQ/freebsd-faq.sgml,v
retrieving revision 1.53
diff -u -r1.53 freebsd-faq.sgml
--- freebsd-faq.sgml	1996/07/28 22:46:27	1.53
+++ freebsd-faq.sgml	1996/08/03 12:00:38
@@ -1734,7 +1734,7 @@
           be enough to get you started.
 
       <sect1>
-        <heading>&quot;make world&quot; clobbers my existing installed binaries.</heading>
+        <heading>``make world'' clobbers my existing installed binaries.</heading>
 
         <p>
 	  Yes, this is the general idea; as its name might suggest,
@@ -1810,8 +1810,8 @@
          <heading>When I run xconsole, I get ``Couldn't open console''.</heading>
         <p>
           If you start X with 'startx', the permissions on /dev/console will
-          <tt /not/ get changed, resulting in things like 'xterm -C' and
-          'xconsole' not working.
+          <tt /not/ get changed, resulting in things like 'xterm -C'
+          and 'xconsole' not working.
     
          <p>
            This is because of the way console permissions are set by default.
@@ -3072,10 +3072,10 @@
           and several thousand students trying to use them...
         <p>
           Make an entry for your university in <tt>/etc/remote</tt>
-          and use <tt>\@</tt> for the <tt/pn/ capability:
+          and use @ for the <tt/pn/ capability:
           <verb>
             big-university:\
-            :pn=\@:tc=dialout
+            :pn=@:tc=dialout
             dialout:\
             :dv=/dev/cuaa3:br#9600:at=courier:du:pa=none:
           </verb>


------                                                            ------ 
Philippe Charnier                               charnier@lirmm.fr (smtp)       
                                          charnier@xp11.frmug.org (uucp) 

    ``a PC not running FreeBSD is like a venusian with no tentacles'' 
------------------------------------------------------------------------