Hi Rony,
I finally have had an opportunity to look into this issue. I downloaded
your version of rexxpg and opened it next to the one that comes with the
ooRexx build which is "pre-split" so it has none of the changes that you
have made. One thing I noticed was that you have added tags "inside" the
examples which I had not seen before. My understanding of the
<programlisting> tag was that it was supposed to show code examples or
snippets "as-is" with the possible exception of syntax highlighting, a
separate issue. Now, as you have demonstrated, you CAN "tag" parts of a
<code> or <programlisting> section but I don't see the benefit of doing
so. Similarly, tagging words in the section titles causes the TOC (which
is automatically generated) to display them accordingly. So, if it were
me doing the work, I would only use the tags in the paragraphs where
they draw the distinction between the prose and the "names" of important
things. Again, just my opinion. Our documents have always only used the
three types of typographic conventions described in the the Preface of
each book. Deviating from that "standard" needs a whole lot more
discussion and consideration IMHO.
Gil
On 3/20/2020 9:15 AM, Rony G. Flatscher wrote:
On 19.03.2020 14:31, Gil Barmwater wrote:
Having spent some time looking at the documentation while developing the system
to build the
books, I found that we actually have a set of conventions on how things are
displayed. This is
part of every document, under the title "Typographic Conventions", right near
the beginning of the
book. So this proposal seems rather extreme to me as it could have a major
impact on all our
documents. Just my opinion.
Gil, of course there is no intention to have any negative impact on the
documentation!
The current boldness is quite strong and looking at the rexxpg book (also in
the TOC!) the bolded,
monotype text stands out prominently. Hence wondering whether removing the
boldness (but leaving it)
to semi-bold would be possible at all. And if it was possible it still needs to
be assessed whether
it negatively impacts the overall look-and feel of the books.
---rony
_______________________________________________
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel
--
Gil Barmwater
_______________________________________________
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel
