Package: debian-reference
Version: 2.89
Severity: normal
For the record why some contents are changed, I list here the reason
and motivation behind updates.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
FTP is not used by Debian nor Linux kernel archive any more
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* "1.3.8. FTP virtual filesystem of MC"
This needs to be replaced by more useful Shell link
(SFTP link is OK but its usage is not as popular)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Virtualbox is in sid but not released
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* "9.11.5. Multiple desktop systems"
Currently, KVM can handle USB so no more reason to use Virtualbox.
Let's drop Virtualbox reference. (KVM now can deal USB devices)
Mention "Virtual Machine Manager" for managing virtual machines of KVM.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
IP header size of IPv6 is 40
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* "5.5.1. Finding optimal MTU"
Now: (with offset of 28 bytes for the IP+ICMP header)
Correct: (with offset of 20+8 bytes for the IP(IPv4)+ICMP header or
with offset of 40+8 bytes for the IP(IPv6)+ICMP header)
Also things may be more complicated since MTU may be different for IPv4
and IPv6 connection.
$ ping -4 -c 1 -s $((1460-20-8)) -M do www.debian.org
PING (128.31.0.62) 1432(1460) bytes of data.
1440 bytes from mirror-csail.debian.org (128.31.0.62): icmp_seq=1 ttl=47
time=241 ms
--- ping statistics ---
1 packets transmitted, 1 received, 0% packet loss, time 0ms
rtt min/avg/max/mdev = 241.086/241.086/241.086/0.000 ms
$ ping -4 -c 1 -s $((1460-20-8+1)) -M do www.debian.org
PING (149.20.4.15) 1433(1461) bytes of data.
>From aterm.me (192.168.10.1) icmp_seq=1 Frag needed and DF set (mtu = 1460)
--- ping statistics ---
1 packets transmitted, 0 received, +1 errors, 100% packet loss, time 0ms
$ ping -6 -c 1 -s $((1500-40-8)) -M do www.debian.org
PING www.debian.org(mirror-csail.debian.org (2603:400a:ffff:bb8::801f:3e)) 1452
data bytes
1460 bytes from mirror-csail.debian.org (2603:400a:ffff:bb8::801f:3e):
icmp_seq=1 ttl=47 time=230 ms
--- www.debian.org ping statistics ---
1 packets transmitted, 1 received, 0% packet loss, time 0ms
rtt min/avg/max/mdev = 229.943/229.943/229.943/0.000 ms
$ ping -6 -c 1 -s $((1500-40-8+1)) -M do www.debian.org
PING www.debian.org(mirror-csail.debian.org (2603:400a:ffff:bb8::801f:3e)) 1453
data bytes
ping: local error: message too long, mtu: 1500
--- www.debian.org ping statistics ---
1 packets transmitted, 0 received, +1 errors, 100% packet loss, time 0ms
Since properly configured network with PMTU mechanism normally functions
without manually tweaking MTU, I should cut down content and leave
pointers.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
No more NPAPI
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* "6.1.1. Browser configuration"
Initially, I saw old reference to now unsed directory:
"/usr/lib/iceweasel/plugins/"
If we ever mention
"/usr/lib/mozilla/plugins/"
But more over, considering general trend of NPAPI deprecation
drop reference to NPAPI altogether.
https://en.wikipedia.org/wiki/NPAPI
It's about time to mention WebExtensions
https://en.wikipedia.org/wiki/Add-on_(Mozilla)
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Chrome_incompatibilities
https://wiki.mozilla.org/WebExtensions
https://github.com/w3c/webextensions/blob/main/charter.md
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Update useragent string settings
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* "6.1.1. Browser configuration"
There is no more ~/.gnome2/epiphany/mozilla/epiphany/user.js to set user
agent name. This useragent tip is something I wanted to keep. (User CSS
is too special use case to deserve mention here. So let me focus only
useragent string)
https://www.whatismybrowser.com/guides/how-to-change-your-user-agent/?utm_source=whatismybrowsercom&utm_medium=internal&utm_campaign=breadcrumbs
https://www.thefastcode.com/en-usd/article/how-to-change-your-browser-s-user-agent-without-installing-any-extensions
https://www.howtogeek.com/113439/how-to-change-your-browsers-user-agent-without-installing-any-extensions/
firefox: about:config (this is still there but not obvious how to do it.)
-> https://www.whatismybrowser.com/guides/how-to-change-your-user-agent/firefox
chrome://settings/ for chromium and menu accessible from settings
doesn't reach useragent easily
-> https://developer.chrome.com/docs/devtools/device-mode/override-user-agent/
-> https://geekflare.com/change-user-agent-in-browser/
popup of configure for epiphany but ???
->
https://askubuntu.com/questions/472861/how-to-change-the-user-agent-in-gnome-web-epiphany
-> https://bbs.archlinux.org/viewtopic.php?id=226736
-> https://www.py4u.net/discuss/1098967
Considering UI will change, I shouldn't dig deep into details of
operation steps.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Update input method
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* "8.2.2. The keyboard input for Wayland"
* "8.2.3. The input method support with IBus"
kitty ibus/fcitx5 issue
fcitx5 is API compatible with ibus so GNOME compatible
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
kitty can record shell activities to file
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* "9.1.1. Recording the shell activities cleanly"
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
moving to another window in vim
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* "9.2.2. Customizing vim with external packages"
Use more popular ^H ^J ^ K ^L combination with correct terminal escape
sequence settings.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
mention readonly snapshot on RW-device
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* "10.1.6. Archive media"
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Add more modern tools
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* "11.1.8. Highlighting and formatting plain text data"
markdown
hugo
jakyl
pydoc(reST)
sphinx
asciidoc
Markdown link: [Text](https://www.example.org/index.html)
Asciidoc link: https://www.example.org/index.html[Text]
ReST (sphinx): `Text <https://www.example.org/index.html>`_
Site generation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
format example properly
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
11.2.1. Basic hints for XML
Strange rendering in example.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
No more epub
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
A.3. Document format
-- System Information:
Debian Release: bookworm/sid
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 5.15.0-1-amd64 (SMP w/12 CPU threads)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled
Versions of packages debian-reference depends on:
ii debian-reference-en 2.89
Versions of packages debian-reference recommends:
ii debian-reference-de 2.89
ii debian-reference-es 2.89
ii debian-reference-fr 2.89
ii debian-reference-id 2.89
ii debian-reference-it 2.89
ii debian-reference-ja 2.89
ii debian-reference-pt 2.89
ii debian-reference-zh-cn 2.89
ii debian-reference-zh-tw 2.89
debian-reference suggests no packages.
-- no debconf information
