Skip to content

docs: standardize man page trailers with AUTHORS, COPYRIGHT, and SEE ALSO#192

Merged
inureyes merged 1 commit intomainfrom
docs/standardize-man-page-trailers
Apr 27, 2026
Merged

docs: standardize man page trailers with AUTHORS, COPYRIGHT, and SEE ALSO#192
inureyes merged 1 commit intomainfrom
docs/standardize-man-page-trailers

Conversation

@inureyes
Copy link
Copy Markdown
Member

Summary

Standardize the trailing sections of all three man pages (bssh.1, bssh-keygen.1, bssh-server.8) so they follow a consistent layout and provide uniform attribution and licensing information.

Changes

  • Reorder trailers into the conventional BUGS → AUTHORS → COPYRIGHT → SEE ALSO sequence common to Unix manual pages.
  • Use a single AUTHORS heading across all pages (was a mix of AUTHOR/AUTHORS) with the same byline:

    Written by Jeongkyu Shin inureyes@gmail.com and the Lablup team.
    Developed and maintained by Lablup Inc. as part of the Backend.AI project.

  • Replace the truncated Copyright � glyph in bssh.1 with Copyright (C) and add the standard "no warranty" disclaimer and explicit License: Apache-2.0 line, matching the other two pages.
  • Append a Project homepage: https://github.com/lablup/bssh line at the end of each page.
  • bssh.1: cross-reference the sibling pages (bssh-keygen(1), bssh-server(8)) in SEE ALSO.

No code, behavior, or build configuration changes — documentation only.

Test plan

  • man -l docs/man/bssh.1 renders cleanly with the new section order
  • man -l docs/man/bssh-keygen.1 renders cleanly
  • man -l docs/man/bssh-server.8 renders cleanly
  • No stray characters remain (grep -n $'\xef\xbf\xbd' docs/man/* returns nothing)

…ALSO

Reorganize the trailing sections of all three man pages (bssh.1,
bssh-keygen.1, bssh-server.8) into a consistent BUGS / AUTHORS /
COPYRIGHT / SEE ALSO order matching common Unix manual conventions.
Author attribution, contact email, Apache-2.0 license notice with the
standard "no warranty" disclaimer, and the project homepage link are
now uniform across all three pages.
@inureyes inureyes added type:docs Improvements or additions to documentation priority:low Low priority issue status:review Under review labels Apr 27, 2026
@inureyes inureyes merged commit b184b11 into main Apr 27, 2026
2 checks passed
@inureyes inureyes deleted the docs/standardize-man-page-trailers branch April 27, 2026 20:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

priority:low Low priority issue status:review Under review type:docs Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant