Saturday, October 12, 2019

Documenting a command and referring to it through intersphinx

I am having trouble with the program and option directives. Documentation

rstgen.sphinxconf.base also defines a command directive.

The following is declared in usage.rst of getlino : the Lino installer:

.. command:: getlino configure

.. program:: getlino configure

.. option:: --https

   Bla bla.

So we need intersphinx. Testing different ways to refer to these declarations:

But :option:\`getlino configure --https\` causes a sphinx.errors.SphinxWarning :unknown option: getlino configure --https

https://github.com/sphinx-doc/sphinx/issues/2822

Moved lino-framework.org to a new server

At 18:40 I changed the zone file: lino-framework.org no longer points to 194.204.31.42 but to 167.114.229.225

(py3) luc@tups:~$ ping lino-framework.org
PING lino-framework.org (194.204.31.42) 56(84) bytes of data.
64 bytes from lino-framework.org (194.204.31.42): icmp_seq=1 ttl=56 time=11.5 ms
64 bytes from lino-framework.org (194.204.31.42): icmp_seq=2 ttl=56 time=11.1 ms
64 bytes from lino-framework.org (194.204.31.42): icmp_seq=3 ttl=56 time=11.6 ms
^C
--- lino-framework.org ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2002ms
rtt min/avg/max/mdev = 11.146/11.458/11.651/0.222 ms
(py3) luc@tups:~$ ping lino-framework.org
PING lino-framework.org (167.114.229.225) 56(84) bytes of data.
64 bytes from 225.ip-167-114-229.eu (167.114.229.225): icmp_seq=1 ttl=50 time=48.0 ms
64 bytes from 225.ip-167-114-229.eu (167.114.229.225): icmp_seq=2 ttl=50 time=49.1 ms
^C
--- lino-framework.org ping statistics ---
3 packets transmitted, 2 received, 33% packet loss, time 2003ms
rtt min/avg/max/mdev = 48.004/48.598/49.193/0.634 ms