:date: 2019-10-12 ========================== Saturday, October 12, 2019 ========================== Documenting a command and referring to it through intersphinx ============================================================= I am having trouble with the :rst:dir:`program` and :rst:dir:`option` directives. `Documentation `__ :mod:`rstgen.sphinxconf.base` also defines a :rst:dir:`command` directive. The following is declared in :file:`usage.rst` of :ref:`getlino`:: .. command:: getlino configure .. program:: getlino configure .. option:: --https Bla bla. So we need intersphinx. Testing different ways to refer to these declarations: - :cmd:`getlino configure` - :option:`getlino configure --https` .. program:: getlino configure - :option:`--https` But ``:option:\`getlino configure --https\``` causes a sphinx.errors.SphinxWarning :message:`: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