checkout doc from /home/ncvs

[Giorgos Keramidas]

On 2003-05-07 21:02, radwasteus at yahoo.com wrote:
>--- Giorgos Keramidas <keramida at ceid.upatras.gr> wrote:
>> On 2003-05-06 18:46, AR9U <radwasteus at yahoo.com> wrote:
>>> errors are a big file even i have cut some parts away.
>>> but i will give you.
>>
>>> Script started on Tue May  6 09:18:16 2003
>>> bank@/home/manee/tmp/doc/en_US.ISO8859-1# make FORMAT="html"
>>> ===> articles
>>> ===> articles/5-roadmap
>>> /usr/local/bin/jade -V [...]
>>> /usr/local/bin/jade:[...]/article.sgml:24:0:E: DTD did not contain element declaration for document type name
>>> [...]
>>
>> It seems you're missing some of the environment vars
>> mentioned in the
>> "FreeBSD Doc. Project Primer for New Contributors".
>
> well, am reading it and do setting some env. vars. but
> as a plain user.

That's fine.  You don't need to be root to build or install the docs.

> that plain user can su to root.
>
>> What is the output
>> of the following command?
>>
>> 	$ env | grep SGML
>
> arg ya, as you expect it gives nothing for the root
> user but give the same result as FDP suggested.

Do you mean you are building the documentation as root?  (When
describing what you are doing, the reader shouldn't have to guess what
you did.  Always remember to provide ALL the details.)

If this is the case, bear in mind that after you run su your old
environment goes away, unless you use the -m option.

> do we need to run this particular make as root ?

No.  Not necessarily.  You'll have to use su to become root only if you
want to install the docs in `/usr/share/doc'.  If you do use su, then
please make sure your environment contains the proper SGML_xxx
variables, either by manually setting them, or by using the -m option of
su(1).

- Giorgos


PS: Your mailer claims that the message is encoded in US-ASCII, but your
From: lines contain some unreadable parts.  Try to configure your mailer
to use the proper encoding for all the stuff it puts in mail headers, or
disable 8-bit characters in mail headers.  If this isn't possible,
perhaps there is a way to spell your name using US-ASCII characters
only (at least in mail headers)?