Menu

#14 [PATCH] svn 602: Improved manual page (rewritten)

Unstable (example)
wont-fix
nobody
None
5
2021-03-13
2010-12-10
Jari Aalto
No

The current manual page recordmydesktop/doc/recordmydesktop.1 could you a touch here and there. There are many ".br" command that should not be there because line widths varies from terminal to terminal etc.

There are 3 files attached:
1. How the original svn 602 looks like
2. How the corrected manual page looks like when corrected.
3. The rewritten manual page.
4. The patch, just in case it is of any use.

Changes are quite bug, so diff wouldn't be of any help:
- List options in alphabetical order
- Remove excessive bold, italic that light the document like a christmas tree.
- Use proper .SS subheading to group options.
- Define Vb, Ve macros for literal code
- Move top level section in order defined by the POSIX manual page standard:
http://www.opengroup.org/onlinepubs/009695399/utilities/xcu_chap01.html#tag_01_11
- etc.

Please consider using this improved page.

Thanks,
Jari Aalto

Discussion

  • Jari Aalto

    Jari Aalto - 2010-12-10

    Original manual page output

     
  • Jari Aalto

    Jari Aalto - 2010-12-10

    Output of corrected manual page

     
  • Jari Aalto

    Jari Aalto - 2010-12-10

    Corrected, new manual page

     
  • Martin Nordholts

    Thanks for taking a look at this. I recently applied another patch I found to the new official GitHub project: https://github.com/Enselic/recordmydesktop/commit/1cea3527e55c847af99d837f85c247ecad7b296c

    So I'm afraid I have to close this as wont-fix. Feel free to create new Pull Requests against the new GitHub project if you can find more improvements though.

     
  • Martin Nordholts

    • status: open --> wont-fix
    • Group: --> Unstable (example)
     

Log in to post a comment.