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

Re: Bug#91892: Small problem with Layout of pdf documentation



Ardo,

I do not see the exact problem on current installmanual in section 5.4
but see similar problem in appendix.  (I remember seeing it a lot with
the old woody TEX before freeze.)

With the released woody version of TEX, run over of right margin by URL
is rare (mostly <example> section.  I am limiting 72char/line for that
to avoid this.)

Problem in appendix is happening with TAGLIST's TAG. Somewhat similar
to Bug 61038.

Something like:

<taglist>
 <tag>Title of section
  <taglist>
   <tag><ref id="&long-url1;" name="long-name1">
   <tag><ref id="&long-url2;" name="long-name2">
   <tag><ref id="&long-url3;" name="long-name3">
   <item>Explanation
  </taglist>
...
</taglist>

For me, this can be easily fixed by avoiding this aggressive use of tag
list. I wonder following does better?

<sec?>Title of section
<list compact>
 <item><ref id="&long-url1;" name="long-name1">
 <item><ref id="&long-url2;" name="long-name2">
 <item><ref id="&long-url3;" name="long-name3">
</list>
<p>Explanation
</sec?>
...

We may add <strong>...</> to emulate bold.

Can you confirm exact location of problem?  There may be a way to fix
this without hacking with debiandoc-sgml which seem to work fine for me.
My "Debian Reference" has quite a bit of long URL.

TAG to me sounds like some short header thus may not need folding line
capability.

Cheers :)

On Tue, Jul 30, 2002 at 07:41:45PM -0500, Ardo van Rangelrooij wrote:
> Hi,
> 
> I've looked at this problem from all sides, asked on the TeX news group
> for help & insight, but all unfortunately to no avail.  This problem is
> apparently not solvable given the (current) limitations of LaTeX.  I also
> don't want to go down the road of "drastically" changing things only to
> make this particular issue go away.
> 
> The only solution I see is to document this in a new 'Limitations' section
> in the DebianDoc-SGML documentation.  HTML doesn't support compact lists,
> so no backend is perfect.
> 
> Thanks,
> Ardo
> 
> Adam Di Carlo (adam@onshore.com) wrote:
> > 
> > reassign 91892 debiandoc-sgml
> > thanks
> > 
> > Barry Say <b.j.say@durham.ac.uk> writes:
> > 
> > > In section 5.4 of the new installation maual (21 March 2001) there are
> > > many URL references.
> > > These are all longer than the width of the page and are curtailed.
> > > I think this is just a problem with the translation to pdf
> > > 
> > > Otherwise the manual seems fine.
> > 
> > Yeah, that's kinda a TeX or debiandoc2latex problem.  I'm taking the
> > liberty to reassign that to the debiandoc-sgml.
> > 
> > -- 
> > .....Adam Di Carlo....adam@onshore.com.....<URL:http://www.onshored.com/>
> > 
> > 
> 
> -- 
> Ardo van Rangelrooij
> home email: ardo@debian.org
> home page:  http://people.debian.org/~ardo
> GnuPG fp:   3B 1F 21 72 00 5C 3A 73  7F 72 DF D9 90 78 47 F9
> 
> 
> -- 
> To UNSUBSCRIBE, email to debian-doc-request@lists.debian.org
> with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
> 
> 

-- 
~\^o^/~~~ ~\^.^/~~~ ~\^*^/~~~ ~\^_^/~~~ ~\^+^/~~~ ~\^:^/~~~ ~\^v^/~~~ +++++
 Osamu Aoki @ Cupertino CA USA
 See "User's Guide":     http://www.debian.org/doc/manuals/users-guide/
 See "Debian reference": http://www.debian.org/doc/manuals/debian-reference/
 "Debian reference" Project at: http://qref.sf.net

 I welcome your constructive criticisms and corrections.



Reply to: