[RPL/2] Documentation issues: Cropped text. Question: Up-to-dateness information? Suggestion: Include in sources.

linux.felixbecker2 at gmx.de linux.felixbecker2 at gmx.de
Sat Sep 26 10:27:34 CEST 2026


Another issue report:

Your French documentation `reference_rpl_french.ps.bz2` [1] is on page
156 cropped:

Content flows out of the page; there seems to be more content that
cannot be read.

In particular, the last lines I see are

> 24.22  GET
> 24.23  GETi

and then I only the the upper part of some letters that resemble to be
also some sort of "Get".

Similar on pages 212 and 234.


By the way, can the "up-to-date"ness of the documentation been seen
anywhere? There are conflicting date informations:

* Inside the document, on the front page, there is written "8 septembre
  2010", whereas
* on the website
  https://rpl2.systella.fr/telechargements.php#documentation, in front
  of the download link, it is written "2020-06-10".


And, a suggestion:

Include the documentation source files in the RPL/2 download sources,
so RPL/2 build can also build documentation (and people can build in
other file formats if they like: Parsing plain .tex or some generated
markdown is easier to "grep" for some text if someone is just
searching for some word, since LaTeX replaces normal characters by
special stuff like ligatures, or introduces linebreaks, which are very
good vor human eye, but bad for searching), and _maybe_ it makes easier
to start some translations?


Regards and thanks for the project!

[1] https://rpl2.systella.fr/download/reference_rpl_french.ps.bz2
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 833 bytes
Desc: OpenPGP digital signature
URL: <http://www.systella.fr/pipermail/rpl2/attachments/20260926/1888bc3f/attachment-0001.sig>


More information about the RPL2 mailing list