Hi, As of Version 2.92:
> 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) Done. > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > 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. Done > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > 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. Done > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > 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 Done > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > 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. Done > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > Update input method > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > > * "8.2.2. The keyboard input for Wayland" > * "8.2.3. The input method support with IBus" > > > kitty ibus/fcitx5 issue addressed in kitty > fcitx5 is API compatible with ibus so GNOME compatible I should have said: fcitx5 supports not only its native API but also API compatible with ibus so GNOME compatible. im-config takes care complication. > > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > kitty can record shell activities to file > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > > * "9.1.1. Recording the shell activities cleanly" Nah... too special if we dwell on kitty. > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > 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. Done. > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > mention readonly snapshot on RW-device > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > > * "10.1.6. Archive media" Done > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > 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 > Done. Use asciidoctor instead of dead asciidoc. > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > format example properly > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > > 11.2.1. Basic hints for XML > > Strange rendering in example. Done I think (looks good) > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > No more epub > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > > A.3. Document format > Done. > From: Gabriel CORRE <g...@4js.com> > To: Debian Bug Tracking System <1000...@bugs.debian.org> > Subject: Re: Updates to the content required > Date: Wed, 19 Jan 2022 17:59:22 +0100 > Source: debian-reference > Followup-For: Bug #1000991 > > Hello, > > in https://www.debian.org/doc/manuals/debian-reference/ch02.en.html > (in english but also other languages) > > The samples of /etc/apt/source.list use possible wrong url > > There are both mention of : > > ``` > deb http://security.debian.org/debian-security ... > deb http://security.debian.org/ ... > ``` Security archive structure has changed. So I agree we need update. > The website it-self ( https://www.debian.org/security/ ) told to use `deb > http://security.debian.org/debian-security` > > Replace `http://security.debian.org/` by > `http://security.debian.org/debian-security` > > in chapiters: > - [x] 2.1.4 ok : > https://www.debian.org/doc/manuals/debian-reference/ch02.en.html#_debian_archive_basics > - [ ] 2.7.4 need to be fixed : > https://www.debian.org/doc/manuals/debian-reference/ch02.en.html#_updates_and_backports > - [ ] 2.7.6 need to be fixed : > https://www.debian.org/doc/manuals/debian-reference/ch02.en.html#_tracking_literal_testing_literal_with_some_packages_from_literal_unstable_literal > - [ ] 2.7.7 need to be fixed : > https://www.debian.org/doc/manuals/debian-reference/ch02.en.html#_tracking_literal_unstable_literal_with_some_packages_from_literal_experimental_literal > These are fixed in next upload. Osamu
