The latest release of the command-line parser module M_CLI2 has a standalone program
available that will display the help text for the procedures as a substitute for the man(1) pages.
If the program is placed in your search path you can enter
fpm-m_cli2 --help
# additionally, if an fpm(1) user
fpm m_cli2 --help
An example to build it on a typical Linux platform would be
# create a scratch directory for the build
mkdir temp
cd temp
# get the documentation program
curl https://raw.githubusercontent.com/urbanjost/index/main/bootstrap/fpm-m_cli2.f90
# compile the program
gfortran fpm-m_cli2.f90 -o fpm-m_cli2
# copy it to somewhere in your path
mv fpm-m_cli2 $HOME/.local/bin/
With work proceeding on the new fpm(1) repository, and mention of things like tldr(1) and the increasingly popular use of ford(1) and doxygen(1) in Fortran projects I am wondering what ideas there are about support for command-line access to user documentation for fpm repository projects. In addition to being able to search by name and description for an fpm(1) project it would be nice if a command-line interface existed for accessing detailed procedure descriptions.
- web sites and use of CLI browsers (w3m, links, lynx, …)
- wget/curl access to files
- utiltities like tldr, dict, …
- man-pages
- ford, doxygen
- flat text, markdown, html, latex, …
most other languages have a standard way of packaging procedure and command descriptions.
What about for Fortran, or at least for fpm(1) projects? How important is it for it to not require www access?