[xml/sgml-pkgs] Bug#800537: linuxdoc-tools documentation is built during the install stage

[Agustin Martin]

2015-10-16 18:49 GMT+02:00 Ilya Tumaykin <itumaykin at gmail.com>:
> On Wednesday 14 October 2015 15:20:23 Agustin Martin wrote:
>> Just pushed to gitlab another set of commits that, amongst other things,
>> should deal with regressions in --with-installed-iso-entities and
>> --with-installed-entity-map. Hope 0.9.70 is now closer.
>
> I've tested your most recent changes and I can confirm that the 'iso-entities'
> problem is now fixed, i.e. docs are built with '--with-installed-iso-entities'
> option both enabled and disabled. Thank you.

Hi, thanks for the info

> I've discovered another problem with txt docs only, i.e 'doc/guide.txt' file.
> All extended formatting like headings, lists, etc. in txt docs has control
> characters inside. See the attached file. For example, this is how '1.
> Introduction' heading looks like:
>
> 1 1. .  I In nt tr ro od du uc ct ti io on n
>
> These control characters are all the same. The rest of the text looks normal.
> pdf and html docs don't have this problem as well. This issue occurs with '--
> with-installed-iso-entities' option both enabled and disabled.

Default behavior of text backend is to ship those control characters.
They will emulate bold and friends if terminal and viewer support
control characters. In my xfce4 or xterm terminals "less" displays
that correctly (but e.g., mc viewer not). They can be disabled by
means of the --filter option.

Since guide.txt should be the version of the guide that is accesible
by any viewer, it is probably better to have it without control
characters. Yet another pending makedoc.sh change to commit (together
with making it sh portable and removing some hardcoded paths).

If no further problems appear and I have time, I'd expect to have
everything ready somewhere next week.

Regards,

-- 
Agustin