[GNUnet-developers] texinfo+images (for grothoff)

2018-05-09 Thread Nils Gillmann
Hi Christian,

I tried to clean up the last documentation commit you made. However I
have no time right now to read into how images are to be included in
texinfo-5. If you have time today or tomorrow, could you please look
into this?

Thanks!

Last output of a build here:

Underfull \hbox (badness 7308) in paragraph at lines 3748--3756
@texttt "@textrm GNUNET[]RUNTIME[]DIR@texttt " @textrm to @texttt "@textrm /var
/run/gnunet/@texttt " @textrm and @texttt "@textrm GNUNET[]HOME@texttt " @textr
m to
[52] [53] [54] [55]) (./chapters/user.texi Chapter 4 [56] [57] [58] [59]
[60] [61] [62]
Overfull \hbox (52.10646pt too wide) in paragraph at lines 553--558
[]@textrm The pri-vate keys of your egos are stored in the di-rec-tory @texttt
~/.local/share/gnunet/identity/egos/[]@textrm .
[63] [64] [65]
Overfull \hbox (25.18033pt too wide) in paragraph at lines 790--790
[]@texttt hosts: files gns [NOTFOUND=return] mdns4_minimal [NOTFOUND=return] d
ns mdns4[]
[66] [67] [68] [69] [70] [71] [72] [73] [74] [75] [76]
Overfull \hbox (197.64096pt too wide) in paragraph at lines 1765--1766
[]@texttt Name: pet; RRType: GNS2DNS; Value: gnunet.org@ns-joker.+ Name: ns-jo
ker; RRType: A; Value: 184.172.157.218[]
(images/gns.eps
./chapters/user.texi:1810: Could not open file images/gns.eps, ignoring it.
@epsfgetbb ...Could not open file #1, ignoring it}
@else {@chardef @other = 1...

@next #1->@epsfgetbb {#1}
@epsfsetgraph {#1}
@imagexxx ...ysize =#3@relax @fi @epsfbox {#1.eps}
@else @doxeteximage {#1}{#...

@image ...true @fi @else @imagexxx #1,@finish
@fi
l.1810 .../gns,6in,, picture of DNS-GNS data flow}

?
./chapters/user.texi:1810: Emergency stop.
@epsfgetbb ...Could not open file #1, ignoring it}
@else {@chardef @other = 1...

@next #1->@epsfgetbb {#1}
@epsfsetgraph {#1}
@imagexxx ...ysize =#3@relax @fi @epsfbox {#1.eps}
@else @doxeteximage {#1}{#...

@image ...true @fi @else @imagexxx #1,@finish
@fi
l.1810 .../gns,6in,, picture of DNS-GNS data flow}

Output written on gnunet.dvi (80 pages, 263068 bytes).
Transcript written on gnunet.log.
/gnu/store/2qb43z2a2l7djz5qnqqrjlc29wdpl7mx-texinfo-5.2/bin/texi2dvi: tex 
exited with bad status, quitting.

___
GNUnet-developers mailing list
GNUnet-developers@gnu.org
https://lists.gnu.org/mailman/listinfo/gnunet-developers


Re: [GNUnet-developers] texinfo+images (for grothoff)

2018-05-09 Thread Christian Grothoff
On 05/09/2018 10:44 AM, Nils Gillmann wrote:
> Hi Christian,
> 
> I tried to clean up the last documentation commit you made. However I
> have no time right now to read into how images are to be included in
> texinfo-5. If you have time today or tomorrow, could you please look
> into this?

Sure, I've added the eps, so now texi2pdf gnunet.texi works (for me...).



signature.asc
Description: OpenPGP digital signature
___
GNUnet-developers mailing list
GNUnet-developers@gnu.org
https://lists.gnu.org/mailman/listinfo/gnunet-developers


Re: [GNUnet-developers] texinfo+images (for grothoff)

2018-05-09 Thread Nils Gillmann
Christian Grothoff transcribed 2.7K bytes:
> On 05/09/2018 10:44 AM, Nils Gillmann wrote:
> > Hi Christian,
> > 
> > I tried to clean up the last documentation commit you made. However I
> > have no time right now to read into how images are to be included in
> > texinfo-5. If you have time today or tomorrow, could you please look
> > into this?
> 
> Sure, I've added the eps, so now texi2pdf gnunet.texi works (for me...).
> 

okay, thanks.
I think it would be better to generate the eps from dot, but for now it's okay.


> ___
> GNUnet-developers mailing list
> GNUnet-developers@gnu.org
> https://lists.gnu.org/mailman/listinfo/gnunet-developers



signature.asc
Description: PGP signature
___
GNUnet-developers mailing list
GNUnet-developers@gnu.org
https://lists.gnu.org/mailman/listinfo/gnunet-developers


Re: [GNUnet-developers] texinfo+images (for grothoff)

2018-05-09 Thread Nils Gillmann
Nils Gillmann transcribed 2.3K bytes:
> Christian Grothoff transcribed 2.7K bytes:
> > On 05/09/2018 10:44 AM, Nils Gillmann wrote:
> > > Hi Christian,
> > > 
> > > I tried to clean up the last documentation commit you made. However I
> > > have no time right now to read into how images are to be included in
> > > texinfo-5. If you have time today or tomorrow, could you please look
> > > into this?
> > 
> > Sure, I've added the eps, so now texi2pdf gnunet.texi works (for me...).
> > 
> 
> okay, thanks.
> I think it would be better to generate the eps from dot, but for now it's 
> okay.

Eh. It's not okay, when you use the rundoc script.

[66] [67] [68] [69] [70] [71] [72] [73] [74] [75] [76]
Overfull \hbox (197.64096pt too wide) in paragraph at lines 1765--1766
[]@texttt Name: pet; RRType: GNS2DNS; Value: gnunet.org@ns-joker.+ Name: ns-jo
ker; RRType: A; Value: 184.172.157.218[]
./chapters/user.texi:1810: Could not find image file images/gns for pdf.
@dopdfimage ...uld not find image file #1 for pdf}
@else @gdef @pdfimgext {JP...

@imagexxx ...t @fi @ifpdf @dopdfimage {#1}{#2}{#3}
@else @ifx @XeTeXrevision ...

@image ...true @fi @else @imagexxx #1,@finish
@fi
l.1810 .../gns,6in,, picture of DNS-GNS data flow}

?
./chapters/user.texi:1810: Emergency stop.
@dopdfimage ...uld not find image file #1 for pdf}
@else @gdef @pdfimgext {JP...

@imagexxx ...t @fi @ifpdf @dopdfimage {#1}{#2}{#3}
@else @ifx @XeTeXrevision ...

@image ...true @fi @else @imagexxx #1,@finish
@fi
l.1810 .../gns,6in,, picture of DNS-GNS data flow}

./chapters/user.texi:1810:  ==> Fatal error occurred, no output PDF file produc
ed!
Transcript written on gnunet.log.
/gnu/store/2qb43z2a2l7djz5qnqqrjlc29wdpl7mx-texinfo-5.2/bin/texi2dvi: pdftex 
exited with bad status, quitting.





Could be that simply texi2pdf works, the simple .info output supports no
images, so for those who just run the normal process it's okay.


signature.asc
Description: PGP signature
___
GNUnet-developers mailing list
GNUnet-developers@gnu.org
https://lists.gnu.org/mailman/listinfo/gnunet-developers


Re: [GNUnet-developers] texinfo+images (for grothoff)

2018-05-09 Thread Christian Grothoff
I now ran run-gendocs.sh on my system, and it additionally wanted a JPG
for the HTML. But without it, the error message was completely
different, so I don't know if that helps on your system.

On 05/09/2018 11:36 AM, Nils Gillmann wrote:
> Eh. It's not okay, when you use the rundoc script.



signature.asc
Description: OpenPGP digital signature
___
GNUnet-developers mailing list
GNUnet-developers@gnu.org
https://lists.gnu.org/mailman/listinfo/gnunet-developers


Re: [GNUnet-developers] texinfo+images (for grothoff)

2018-05-09 Thread Nils Gillmann
Christian Grothoff transcribed 2.7K bytes:
> I now ran run-gendocs.sh on my system, and it additionally wanted a JPG
> for the HTML. But without it, the error message was completely
> different, so I don't know if that helps on your system.
> 
> On 05/09/2018 11:36 AM, Nils Gillmann wrote:
> > Eh. It's not okay, when you use the rundoc script.
> 

I started using that script because it seems to be what most of the
other GNU projects are using.

We have to separate this here:

Let's try to not introduce a dependency on dot unless absolutely necessary

Maybe we could generate the data for the documentation, that is intended for
outputs that are not necessary part of the main distribution, in the 
run-gendocs.sh
script?

I'll look into the Makefiles in doc later.

I'm running low on battery, can't reply more.

signature.asc
Description: PGP signature
___
GNUnet-developers mailing list
GNUnet-developers@gnu.org
https://lists.gnu.org/mailman/listinfo/gnunet-developers


Re: [GNUnet-developers] texinfo+images (for grothoff)

2018-05-09 Thread Christian Grothoff
On 05/09/2018 11:53 AM, Nils Gillmann wrote:
> Christian Grothoff transcribed 2.7K bytes:
>> I now ran run-gendocs.sh on my system, and it additionally wanted a JPG
>> for the HTML. But without it, the error message was completely
>> different, so I don't know if that helps on your system.
>>
>> On 05/09/2018 11:36 AM, Nils Gillmann wrote:
>>> Eh. It's not okay, when you use the rundoc script.
>>
> 
> I started using that script because it seems to be what most of the
> other GNU projects are using.
> 
> We have to separate this here:
> 
> Let's try to not introduce a dependency on dot unless absolutely necessary
> 
> Maybe we could generate the data for the documentation, that is intended for
> outputs that are not necessary part of the main distribution, in the 
> run-gendocs.sh
> script?

Yes, generating from 'dot' when we 'make dist' would be ideal.

> I'll look into the Makefiles in doc later.

:-)



signature.asc
Description: OpenPGP digital signature
___
GNUnet-developers mailing list
GNUnet-developers@gnu.org
https://lists.gnu.org/mailman/listinfo/gnunet-developers