You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@subversion.apache.org by Garrett Rooney <ro...@electricjellyfish.net> on 2002/07/20 16:52:55 UTC
problems building documentation
so i decided to play around with the handbook a bit, just for fun, and
ran into a few snags. here's the changes i had to make to Makefile.in
to get it to build with the tools i have on my FreeBSD box.
Index: ./Makefile.in
===================================================================
--- ./Makefile.in
+++ ./Makefile.in Sat Jul 20 12:24:48 2002
@@ -202,13 +202,13 @@
$(MAKEINFO) -I `dirname $<` -o $@ $<
.texi.dvi:
- wd=`pwd` ; cd `dirname $@` ; $(TEXI2DVI) -I `dirname $$wd/$<` $$wd/$<
+ wd=`pwd` ; cd `dirname $@` ; $(TEXI2DVI) $$wd/$<
.texi.txt:
$(MAKEINFO) -I `dirname $<` --no-headers -o $@ $<
.texi.html:
- $(MAKEINFO) -I `dirname $<` --no-headers --html -o $@ $<
+ $(MAKEINFO) -I `dirname $<` --html -o $@ $<
.dvi.ps:
$(DVIPS) $< -o $@
apparently my version of texi2dvi doesn't have a -I option (although
it seems to work fine without it), and my version of makeinfo
complains if you try to use --no-headers and --html together. this is
with texi2dvi version 0.8 (GNU Texinfo 3.12), and makeinfo version
4.1.
does anyone else have these problems? and if not, can you still build
correctly with these changes? i'd hate to commit a change that works
for me but breaks for everyone else ;-)
-garrett
--
garrett rooney Remember, any design flaw you're
rooneg@electricjellyfish.net sufficiently snide about becomes
http://electricjellyfish.net/ a feature. -- Dan Sugalski
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Re: problems building documentation
Posted by Daniele Nicolodi <da...@grinta.net>.
On Tue, Jul 23, 2002 at 10:26:40PM +0200, Daniele Nicolodi wrote:
> I have your problem in building doc-html but not the doc-dvi one.
> Your pathc for the first one is ok for me, the second doesn't break
> anything for me. I get an error on make doc-clean:
Oh. I'm running Debian Sid (unstable).
$ texi2dvi --version
texi2dvi (GNU Texinfo 4.2) 0.51
$ makeinfo --version
makeinfo (GNU texinfo) 4.2
Ciao
--
Daniele
--- http://www.grinta.net ---
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Re: problems building documentation
Posted by Daniele Nicolodi <da...@grinta.net>.
On Sat, Jul 20, 2002 at 12:52:55PM -0400, Garrett Rooney wrote:
> does anyone else have these problems? and if not, can you still build
> correctly with these changes? i'd hate to commit a change that works
> for me but breaks for everyone else ;-)
I have your problem in building doc-html but not the doc-dvi one.
Your pathc for the first one is ok for me, the second doesn't break
anything for me. I get an error on make doc-clean:
make doc-clean
for d in doc/programmer/design doc/handbook; \
do \
(cd $d; \
rm -f *.info *.info-1 *.info-2 *.info-3 \
*.aux *.cp *.fn *.ky *.log *.pg *.toc \
*.tp *.vr \
*.dvi *.txt *.html *.ps *.pdf); \
done
rm: cannot remove `svn-design.html': Is a directory
rm: cannot remove `svn-handbook.html': Is a directory
make: *** [doc-clean] Error 1
This is the simpliest fix:
Index: ./Makefile.in
===================================================================
--- ./Makefile.in
+++ ./Makefile.in 2002-07-23 22:26:26.000000000 +0200
@@ -174,7 +174,8 @@
rm -f *.info *.info-1 *.info-2 *.info-3 \
*.aux *.cp *.fn *.ky *.log *.pg *.toc \
*.tp *.vr \
- *.dvi *.txt *.html *.ps *.pdf); \
+ *.dvi *.txt *.ps *.pdf; \
+ rm -r -f *.html); \
done
### Build a tarball.
Ciao
--
Daniele
--- http://www.grinta.net ---
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Re: problems building documentation
Posted by Garrett Rooney <ro...@electricjellyfish.net>.
On Tue, Jul 23, 2002 at 03:32:01PM -0700, Blair Zajac wrote:
> If anybody commits this, change the patch to
>
> .texi.html:
> - $(MAKEINFO) -I `dirname $<` --no-headers --html -o $@ $<
> + $(MAKEINFO) -I `dirname $<` --no-split --html -o $@ $<
>
> Otherwise a doc/handbook/svn-handbook/ directory is created which
> doesn't match the Makefile rule to create doc/handbook/svn-handbook.html.
>
> Unless I hear otherwise, I'll commit this in several hours.
well, this works fine with me. if/when this gets committed, we should
remove the 'svn-handbook' dir from the svn:ignore in doc/handbook and
doc/programmer/design. i added them this week, not realizing that
those were only created because i had added --no-headers. i'm new at
this texinfo stuff ;-)
-garrett
--
garrett rooney Remember, any design flaw you're
rooneg@electricjellyfish.net sufficiently snide about becomes
http://electricjellyfish.net/ a feature. -- Dan Sugalski
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Re: problems building documentation
Posted by Blair Zajac <bl...@orcaware.com>.
If anybody commits this, change the patch to
.texi.html:
- $(MAKEINFO) -I `dirname $<` --no-headers --html -o $@ $<
+ $(MAKEINFO) -I `dirname $<` --no-split --html -o $@ $<
Otherwise a doc/handbook/svn-handbook/ directory is created which
doesn't match the Makefile rule to create doc/handbook/svn-handbook.html.
Unless I hear otherwise, I'll commit this in several hours.
Blair
--
Blair Zajac <bl...@orcaware.com>
Web and OS performance plots - http://www.orcaware.com/orca/
Blair Zajac wrote:
>
> On RedHat 7.3 applying these changes gets make doc to work fines
> for me and I need the second one to remove --no-headers from
> running makeinfo.
>
> Blair
>
> Karl Fogel wrote:
> >
> > Garrett, did you ever get any responses to your question at the end of
> > this mail?
> >
> > FWIW, I'm building fine w/o these changes. This is RedHat Linux 7.2.
> >
> > -K
> >
> > Garrett Rooney <ro...@electricjellyfish.net> writes:
> > > so i decided to play around with the handbook a bit, just for fun, and
> > > ran into a few snags. here's the changes i had to make to Makefile.in
> > > to get it to build with the tools i have on my FreeBSD box.
> > >
> > > Index: ./Makefile.in
> > > ===================================================================
> > > --- ./Makefile.in
> > > +++ ./Makefile.in Sat Jul 20 12:24:48 2002
> > > @@ -202,13 +202,13 @@
> > > $(MAKEINFO) -I `dirname $<` -o $@ $<
> > >
> > > .texi.dvi:
> > > - wd=`pwd` ; cd `dirname $@` ; $(TEXI2DVI) -I `dirname $$wd/$<` $$wd/$<
> > > + wd=`pwd` ; cd `dirname $@` ; $(TEXI2DVI) $$wd/$<
> > >
> > > .texi.txt:
> > > $(MAKEINFO) -I `dirname $<` --no-headers -o $@ $<
> > >
> > > .texi.html:
> > > - $(MAKEINFO) -I `dirname $<` --no-headers --html -o $@ $<
> > > + $(MAKEINFO) -I `dirname $<` --html -o $@ $<
> > >
> > > .dvi.ps:
> > > $(DVIPS) $< -o $@
> > >
> > > apparently my version of texi2dvi doesn't have a -I option (although
> > > it seems to work fine without it), and my version of makeinfo
> > > complains if you try to use --no-headers and --html together. this is
> > > with texi2dvi version 0.8 (GNU Texinfo 3.12), and makeinfo version
> > > 4.1.
> > >
> > > does anyone else have these problems? and if not, can you still build
> > > correctly with these changes? i'd hate to commit a change that works
> > > for me but breaks for everyone else ;-)
> > >
> > > -garrett
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Re: problems building documentation
Posted by Blair Zajac <bl...@orcaware.com>.
On RedHat 7.3 applying these changes gets make doc to work fines
for me and I need the second one to remove --no-headers from
running makeinfo.
Blair
Karl Fogel wrote:
>
> Garrett, did you ever get any responses to your question at the end of
> this mail?
>
> FWIW, I'm building fine w/o these changes. This is RedHat Linux 7.2.
>
> -K
>
> Garrett Rooney <ro...@electricjellyfish.net> writes:
> > so i decided to play around with the handbook a bit, just for fun, and
> > ran into a few snags. here's the changes i had to make to Makefile.in
> > to get it to build with the tools i have on my FreeBSD box.
> >
> > Index: ./Makefile.in
> > ===================================================================
> > --- ./Makefile.in
> > +++ ./Makefile.in Sat Jul 20 12:24:48 2002
> > @@ -202,13 +202,13 @@
> > $(MAKEINFO) -I `dirname $<` -o $@ $<
> >
> > .texi.dvi:
> > - wd=`pwd` ; cd `dirname $@` ; $(TEXI2DVI) -I `dirname $$wd/$<` $$wd/$<
> > + wd=`pwd` ; cd `dirname $@` ; $(TEXI2DVI) $$wd/$<
> >
> > .texi.txt:
> > $(MAKEINFO) -I `dirname $<` --no-headers -o $@ $<
> >
> > .texi.html:
> > - $(MAKEINFO) -I `dirname $<` --no-headers --html -o $@ $<
> > + $(MAKEINFO) -I `dirname $<` --html -o $@ $<
> >
> > .dvi.ps:
> > $(DVIPS) $< -o $@
> >
> > apparently my version of texi2dvi doesn't have a -I option (although
> > it seems to work fine without it), and my version of makeinfo
> > complains if you try to use --no-headers and --html together. this is
> > with texi2dvi version 0.8 (GNU Texinfo 3.12), and makeinfo version
> > 4.1.
> >
> > does anyone else have these problems? and if not, can you still build
> > correctly with these changes? i'd hate to commit a change that works
> > for me but breaks for everyone else ;-)
> >
> > -garrett
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Re: problems building documentation
Posted by Karl Fogel <kf...@newton.ch.collab.net>.
Garrett, did you ever get any responses to your question at the end of
this mail?
FWIW, I'm building fine w/o these changes. This is RedHat Linux 7.2.
-K
Garrett Rooney <ro...@electricjellyfish.net> writes:
> so i decided to play around with the handbook a bit, just for fun, and
> ran into a few snags. here's the changes i had to make to Makefile.in
> to get it to build with the tools i have on my FreeBSD box.
>
> Index: ./Makefile.in
> ===================================================================
> --- ./Makefile.in
> +++ ./Makefile.in Sat Jul 20 12:24:48 2002
> @@ -202,13 +202,13 @@
> $(MAKEINFO) -I `dirname $<` -o $@ $<
>
> .texi.dvi:
> - wd=`pwd` ; cd `dirname $@` ; $(TEXI2DVI) -I `dirname $$wd/$<` $$wd/$<
> + wd=`pwd` ; cd `dirname $@` ; $(TEXI2DVI) $$wd/$<
>
> .texi.txt:
> $(MAKEINFO) -I `dirname $<` --no-headers -o $@ $<
>
> .texi.html:
> - $(MAKEINFO) -I `dirname $<` --no-headers --html -o $@ $<
> + $(MAKEINFO) -I `dirname $<` --html -o $@ $<
>
> .dvi.ps:
> $(DVIPS) $< -o $@
>
> apparently my version of texi2dvi doesn't have a -I option (although
> it seems to work fine without it), and my version of makeinfo
> complains if you try to use --no-headers and --html together. this is
> with texi2dvi version 0.8 (GNU Texinfo 3.12), and makeinfo version
> 4.1.
>
> does anyone else have these problems? and if not, can you still build
> correctly with these changes? i'd hate to commit a change that works
> for me but breaks for everyone else ;-)
>
> -garrett
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org