{"id":16096363,"url":"https://github.com/sio/man","last_synced_at":"2025-04-05T20:29:36.972Z","repository":{"id":240203591,"uuid":"801961536","full_name":"sio/man","owner":"sio","description":"View Debian manpages without installing corresponding packages","archived":false,"fork":false,"pushed_at":"2024-05-28T09:41:46.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-11T20:49:53.940Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-17T08:47:16.000Z","updated_at":"2024-05-28T09:41:49.000Z","dependencies_parsed_at":"2024-05-28T12:08:32.921Z","dependency_job_id":"badc188a-317a-4919-a539-73b5ef084569","html_url":"https://github.com/sio/man","commit_stats":null,"previous_names":["sio/man"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sio%2Fman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sio%2Fman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sio%2Fman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sio%2Fman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sio","download_url":"https://codeload.github.com/sio/man/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247398104,"owners_count":20932664,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-09T17:13:46.825Z","updated_at":"2025-04-05T20:29:36.953Z","avatar_url":"https://github.com/sio.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Terminal client for manpages.debian.org\n\nThis tool allows to view Debian manpages in your terminal without installing\nthe corresponding packages (and even without installing Debian).\n\n```\nusage: man [SECTION] MANPAGE\n\nExamples:\n        man man\n        man 2 flock\n        man bookworm/ddrescue\n```\n\nDependencies:\n\n  - groff (from `groff-base` in Debian)\n  - less (or any other pager, will fall back to `cat` if nothing else found)\n\nAll manpages are published and maintained by Debian project.\nThis is just a simple client for \u003chttps://manpages.debian.org\u003e\n\n\n## Installation\n\n  - Build and install with Go: `go install github.com/sio/man/cmd/man@latest`\n\n  - Prebuilt binaries are also available in [GitHub Releases](https://github.com/sio/man/releases).\n\n    The build process is reproducible.\n    Use your own judgement to decide whether to trust the binaries publshed there.\n\n\n## Using this tool to complement OS provided manpages\n\nReplace `man` in your shell with the following function:\n\n```bash\nman() {\n    command man \"$@\" || /path/to/this/man \"$@\"\n}\n```\n\n\n## License and copyright\n\nCopyright 2024 Vitaly Potyarkin\n\n```\n   Licensed under the Apache License, Version 2.0 (the \"License\");\n   you may not use this file except in compliance with the License.\n   You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n   Unless required by applicable law or agreed to in writing, software\n   distributed under the License is distributed on an \"AS IS\" BASIS,\n   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n   See the License for the specific language governing permissions and\n   limitations under the License.\n```\n\n\n## Bugs and possible improvements\n\n- Some manpages are not rendered correctly (try `groff_man`). This may or may\n  not turn out to be an [upstream] bug. Needs further investigation.\n\n- Relative include directives do not work.\n  Try `ash`: \u003chttps://manpages.debian.org/bookworm/ash/ash.1.en.gz\u003e\n\n- Almost 5MB is a rather large size for this simple tool.\n  It may have even been just a single pipe of `curl | groff | less`.\n  Can this be reimplemented in something like Python (stdlib-only) to simplify\n  builds and distribution?\n  Will distributing a Python script be simpler compared to a (large-ish) static binary?\n\n[upstream]: https://github.com/Debian/debiman/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsio%2Fman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsio%2Fman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsio%2Fman/lists"}