[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Starting questions



On Tue, May 11, 2004 at 01:12:36PM +0200, ThomasS wrote:
> Geert Stappers schrieb:
<snip/>
> > Please confirm ( to make sure we are talking about the same files )
> > Did you get those from CVS?
> Yep, as described in http://www.debian.org/doc/cvs, I updated cvs this 
> morning by doing a "cvs -z3 update -d -P"
Okay, the recent information.

> 
> > Please supply the output of   cat CVS/R*
> ddp
> :pserver:anonymous@cvs.debian.org:/cvs/debian-doc
Okay, same over here.

> > 
> > 
> 
> 
> > I did run "make" and got a complete build, without any error.
> > 
> > I assume you allready start changing the Makefile.
> Didn't touch any of them till now...........so no diff's available
> 
> -------------------------------------------------------------------------------------
> 
> The results of rebuilding manuals  step-by-step is very different from 
> directory to directory, i.e. I was not able to rebuild following manuals 
> in the ddp directory for very different reason:
Mmm, various manuals...

> 
> -sgml-howto
> 
> error: /usr/lib/sgml/declaration/xml.dcl howto.db > dump.html
> jade:E: cannot open "/usr/lib/sgml/declaration/xml.dcl" (file or 
> directory not found)
> 
> thomas$: locate xml.dcl [which is part of installed sgml-data package]
> 
> /usr/share/doc/docbook-website/examples/bookmark/xml.dcl.gz
> /usr/share/doc/kde/HTML/en/common/xml.dcl
> /usr/share/sgml/declaration/xml.dcl
> /usr/share/xml/declaration/xml.dcl
> 
> A look at the Makefile in this directory gives:
> 
> XML_DECL=/usr/share/xml/declaration/xml.decl
> 
> Is this a typo : xml.decl instead of xml.dcl ???
> 

Works for me.
(I have a sarge system)

> ---------------------------------------------------------------------------
> 
> thomas@sugar:~/ddp/manuals.sgml/release-notes/de$ make
> 
> architecture variable must be set
> exit 1
> make: *** [../dynamic_.ent] error 1
> 

I got this error also.

> 
> Hmm, where and how to do this?
It is about the potato release. ( It was about the potato release. )
I'm not gonna spent time about it.
Sorry you encountered an old manual source.

> 
> --------------------------------------------------------------------------
> 
> thomas@sugar:~/ddp/manuals.sgml/euro-support$ make
> 
> nsgmls:debian-euro-support.sgml:528:8:E: document type does not allow 
> element "EXAMPLE" here; assuming missing "P" start-tag
> make: *** [debian-euro-support.html] error 1

got that error also.
I assume the buildtools became more stricter.
Apply this patch:
diff -u -r1.34 debian-euro-support.sgml
--- euro-support/debian-euro-support.sgml       22 Mar 2004 16:04:10 -0000     1.34
+++ euro-support/debian-euro-support.sgml       11 May 2004 12:00:24 -0000
@@ -525,6 +525,7 @@
  
 <p>If you are using multiple virtual terminales you might want to add this:
 </P>
+<p>
 <example>
 APP_CHARSET_MAP_vc1=iso15
 APP_CHARSET_MAP_vc2=iso15
@@ -533,6 +534,7 @@
 APP_CHARSET_MAP_vc5=iso15
 APP_CHARSET_MAP_vc6=iso15
 </example>
+</p>
  
 <p>If you are using the <package>kbd</package> package you will need
 to edit the <file>/etc/kbd/config</file> adding, for example:

Could some one commit it into CVS?

> 
> -------------------------------------------------------------------------
> thomas@sugar:~/ddp/manuals.sgml/java-faq$ make

stappers@mir-CHROOT:/usr/src/ddp/manuals.sgml/java-faq
$ make
debiandoc2html debian-java-faq.sgml
[ -d /org/www.debian.org/www/doc/manuals ] || exit 1
make: *** [publish] Error 1

It wants the directory /org/www.debian.org/.......
and stop because it doesn't exsists.

> 
> debiandoc2html debian-java-faq.sgml
> [ -d /org/www.debian.org/www/doc/manuals ] || exit 1
> rm -f /org/www.debian.org/www/doc/manuals/debian-java-faq/*.html
> install -d -m 755 /org/www.debian.org/www/doc/manuals/debian-java-faq
> install: could not create directory 
> ,,/org/www.debian.org/www/doc/manuals/debian-java-faq" : no permission
> 
> This compiles only if you are root ?? Is that the way things should work?

You created probaly the /org directory as.
Take a look at these action and notice what root (#) and stappers($) did

mir-CHROOT:/
# mkdir /org
# id stappers
uid=1000(stappers) gid=1000 groups=1000,40(src)
mir-CHROOT:/
# chgrp src /org
mir-CHROOT:/
# chmod g+w /org
mir-CHROOT:/
#

stappers@mir-CHROOT:/usr/src/ddp/manuals.sgml/java-faq
$ mkdir -p /org/www.debian.org/www/doc/manuals
stappers@mir-CHROOT:/usr/src/ddp/manuals.sgml/java-faq
$

stappers@mir-CHROOT:/usr/src/ddp/manuals.sgml/java-faq
$ make
[ -d /org/www.debian.org/www/doc/manuals ] || exit 1
rm -f /org/www.debian.org/www/doc/manuals/debian-java-faq/*.html
install -d -m 755 /org/www.debian.org/www/doc/manuals/debian-java-faq
install -m 644 --preserve-timestamps debian-java-faq.html/*.html \
                /org/www.debian.org/www/doc/manuals/debian-java-faq/
stappers@mir-CHROOT:/usr/src/ddp/manuals.sgml/java-faq
$

No errors over here.

> 
> ----------------------------------------------------------------------------
> thomas@sugar:~/ddp/manuals.sgml/maint-guide$ make
> 
> debiandoc2html -c -l en maint-guide.sgml
> nsgmls:maint-guide.sgml:37:11:E: the name and vi delimiter can be 
> omitted from an attribute specification only if SHORTTAG YES is specified
> mv: call of stat for ,,maint-guide.html" not possible: File or directory 
> not found
> make: *** [html] error 1
> 
No error over here (as reported before)
Which Debian version are you running?

> ----------------------------------------------------------------------------
> 
> thomas@sugar:~/ddp/manuals.sgml/newbie-doc$ make
> 
> debiandoc2html newbie-doc.sgml
> nsgmls:E: cannot find "newbie-doc.sgml"; tried "newbie-doc.sgml", "/usr/loc
> are/sgml/newbie-doc.sgml", "/usr/local/lib/sgml/newbie-doc.sgml", "/usr/sha
> ml/newbie-doc.sgml"
> make: *** [newbie-doc.html/index.html] error 1
> 
> 
> Is this because of missing sgml files, where can I get these from?
Yes, the sgml file is missing. :-(

I did visit http://cvs.debian.org/ddp/manuals.sgml/newbie-doc/?cvsroot=debian-doc
with the hope to find an Attic like
 http://cvs.debian.org/ddp/manuals.sgml/?cvsroot=debian-doc has.
( Attic is where CVS stores the deleted files )

So I don't know where to find that file?
( Joy, are you here? )

> 
> ----------------------------------------------------------------------------
> 
> thomas@sugar:~/ddp/manuals.sgml/network-administrator$ make
> 
> debiandoc2html network-administrator.sgml
> nsgmls:network-administrator.sgml:85:13:E: the name and vi delimiter can 
> be omitted from an attribute specification only if SHORTTAG YES is specified
> make: *** [network-administrator.html/index.html] error 1

stappers@mir-CHROOT:/usr/src/ddp/manuals.sgml/newbie-doc
$ cd ../network-administrator/
stappers@mir-CHROOT:/usr/src/ddp/manuals.sgml/network-administrator
$ make
debiandoc2html network-administrator.sgml
[ -d /org/www.debian.org/www/doc/manuals ] || exit 1
rm -f /org/www.debian.org/www/doc/manuals/network-administrator/*.html
install -d -m 755 /org/www.debian.org/www/doc/manuals/network-administrator
install -m 644 --preserve-timestamps network-administrator.html/*.html \
                /org/www.debian.org/www/doc/manuals/network-administrator/
stappers@mir-CHROOT:/usr/src/ddp/manuals.sgml/network-administrator
$

> 
> ----------------------------------------------------------------------------
> 
> 
> To come to an end, some manuals compile very fine, i.e. apt-howto, 
> project-history, dselect-beginner or securing-howto just to name a few. 
> Others which are of more interest to me don't rebuild at all, like 
> sgml-howto or network-administrator manuals!

From the information above, I guess it is a toolchain version thing.
unstable, currently sarge, build the docs fine for me.

If you wouldn't switch now, but build the those manuals,
consider building a chroot environment.

> 
> 
> 
> Some of the above described errors don't make any sense to me, like 
> rebuilding java-faq as root or html error for maint-guide manual. 
> Ghee......... hard times for beginners..... ;-)

Believe me, I started also as beginner...   ;-)

> 
> Thanks in advance for helpfull comments

Thank you for reporting issues we weren't aware about.

> 
> 
> yours
> 
> Thomas

Cheers
Geert Stappers

Attachment: pgp8vOvxhvHQi.pgp
Description: PGP signature


Reply to: