• Otto Kekäläinen's avatar
    MDEV-23789: Fix unnecessary acute accents in man pages · e36b6480
    Otto Kekäläinen authored
    The man pages has several places where \' is intended to escape the single
    quote and just print '. However, in reality this will print an ` (acute
    accent). Fix this by removing excess backslashes. Also remove some excess
    & in front of dots, such escaping is also unnecessary.
    
    Also join several lines to avoid lone words in quotes to be read by groff
    as macros when they are just text.
    
    In a table (t{}) the content must be on new lines separately, so groff
    will try to read them as macros too, so use \(aq that renders to '
    (single quote).
    
    This error was originally detected by Lintian:
    https://lintian.debian.org/tags/acute-accent-in-manual-page
    
    Example of man page sections before and after:
    
      Make a backup of each table´s data file using the name tbl_name.OLD.
      ->
      Make a backup of each table's data file using the name tbl_name.OLD.
    
      A typical debug_options string is ´d:t:o,file_name´.
      The default is ´d:t:o,/tmp/my_print_defaults.trace´.
      ->
      A typical debug_options string is 'd:t:o,file_name'.
      The default is 'd:t:o,/tmp/my_print_defaults.trace'.
    
      shell> mysql --xml -uroot -e "SHOW VARIABLES LIKE ´version%´"
      <?xml version="1.0"?>
      <resultset statement="SHOW VARIABLES LIKE ´version%´" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      ->
      shell> mysql --xml -uroot -e "SHOW VARIABLES LIKE 'version%'"
      <?xml version="1.0"?>
      <resultset statement="SHOW VARIABLES LIKE 'version%'" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    
    This command was used to validate no man pages have syntax errors:
    
      for x in *.?
      do
        echo "##### $x #####"
        LC_ALL=C.UTF-8 MANROFFSEQ='' MANWIDTH=80 man --warnings -E UTF-8 -l -Tutf8 -Z $x >/dev/null
      done
    
    The man pages are not perfect after this, there are still a lot of
    suboptimal syntax, but this helps towards better man pages.
    
    All new code of the whole pull request, including one or several files
    that are either new files or modified ones, are contributed under the
    BSD-new license. I am contributing on behalf of my employer Amazon Web
    Services, Inc.
    e36b6480
my_print_defaults.1 5.49 KB