en/books/porters-handbook/makefiles has code block with example of shell commands, and two lines of the example are started with '=' char. These lines are considered as the header,
that influence the correct creation of PO file for translation (code block becomes corrupted). As result, all translated ADOC files require manual work to fix lines, generated for this code block.
Proposed patch insert space char in the beginning of lines with =, < and > chars. As result, the code block is considered as one paragraph (as it must be), English text is rendered correctly,
PO files is created correctly, ADOC after translation will not need manual work.
Example of the manual work - commit ce5f6f10a0d09bf2fcd49165abec22cfaaf67ff5.
Related reviews:
https://reviews.freebsd.org/D52710 - commited
https://reviews.freebsd.org/D52678 - waits for approval
All these three patches fix issues that are require manual work as in the commit above.