[PATCH] rtems-docs: Eliminate UTF-8 characters, PDF still broken

Joel Sherrill joel at rtems.org
Wed Dec 19 16:42:48 UTC 2018


Some of the .rst files had gotten UTF-8 characters for matching single quotes,
matching double quotes, dashes, and @ symbols. This is easy to do when copying
from wiki pages, MS-Word, PDF, etc. On one page, the character preceding the 
hyperlink on a Trac wiki page was included.

This command finds and highlights non-ASCII characters:

  find . -name "*.rst" | xargs -e file | grep Unicode | \
    cut -d':' -f1 | xargs -e grep --color='auto' -P -n '[^\x00-\x7F]'

One place I didn't know how to fix was bsp-howto/i2c.rst where I2C uses
a UTF-8 superscripted 2. I couldn't figure out how to represent that in
pure ASCII and Rest markup. :sup:`2` should work but does not. I left 
a comment in the file about this.

The PDF generation still fails at exactly the same place in the Users Guide
(Users not Classic API). There is no obvious reason even with verbose output
turned on from waf.


Joel Sherrill (1):
  Eliminate UTF-8 characters

 bsp-howto/i2c.rst             |  5 ++++-
 eng/appendix-a.rst            |  6 +++---
 eng/license-requirements.rst  |  2 +-
 eng/prequalification.rst      | 16 ++++++++--------
 eng/test-plan.rst             |  2 +-
 eng/users-manuals.rst         |  2 +-
 eng/vc-authors.rst            |  6 +++---
 eng/vc-users.rst              | 15 ++++++++-------
 user/tracing/examples.rst     |  2 +-
 user/tracing/introduction.rst |  6 +++---
 10 files changed, 33 insertions(+), 29 deletions(-)


More information about the devel mailing list