os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

relnotes/13.0R: Use gitref macro instead of shortcodes

Browse source 
The gitref macro added in commit fb36cfdfb2 handles changes in both src,
doc and ports trees, takes up less space, and is quicker to write, so
update all uses of the commit shortcode.

While here, also update the canonical sample that's commented out.

Also re-arrange some items which were initially placed in the wrong
sections.

Since the shortcode is now no longer used, remove it.
This commit is contained in:
Daniel Ebdrup Jensen 2021-02-14 11:13:37 +01:00
parent fee800a873
commit e6645e5aee
2 changed files with 54 additions and 57 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

110
website/content/en/releases/13.0R/relnotes.adoc
View file

@ -89,7 +89,7 @@ This section lists the various Security Advisories and Errata Notices since {rel
|===
// Sample release notes entry.
//The man:fsck_msdosfs[8] utility has been updated to include a variety of enhancements, including reducing the memory footprint, a new flag, `-M`, which disables the use of man:mmap[2], and others. {{< revision "357568" >}}
//The man:fsck_msdosfs[8] utility has been updated to include a variety of enhancements, including reducing the memory footprint, a new flag, `-M`, which disables the use of man:mmap[2], and others. gitref:9708ba9f29[repository=src]
[[userland]]
== Userland
@ -103,35 +103,25 @@ This section covers changes and additions to userland applications, contributed
[[userland-programs]]
=== Userland Application Changes
The {{< manpage "daemon" "8" >}} utility now supports the -H flag, which causes it to catch SIGHUP and re-open the syslog file received, so log rotation from {{< manpage "newsyslog" "8">}} works properly. {{< commit "4cd407ec933" >}}
The {{< manpage "daemon" "8" >}} utility now supports the `-H` flag, which causes it to catch SIGHUP and re-open the syslog file received, so log rotation from {{< manpage "newsyslog" "8">}} works properly. gitref:4cd407ec933[repository=src]
The {{< manpage "daemon" "8" >}} utility no longer blocks SIGTERM during the restart delay. {{< commit "09a3675d961" >}}
The {{< manpage "daemon" "8" >}} utility no longer blocks SIGTERM during the restart delay. gitref:09a3675d961[repository=src]
The {{< manpage "diskinfo" "8" >}} utility now reports the physical device name GEOM attribute when available. {{< commit "b5961be1ab7" >}}
The {{< manpage "diskinfo" "8" >}} utility now reports the physical device name GEOM attribute when available. gitref:b5961be1ab7[repository=src]
The {{< manpage "ctld" "8" >}} utility now supports the -f flag, which tests the configuration file validity. {{< commit "7fcbecd004f" >}}
The {{< manpage "freebsd-update" "8" >}} utility now displays progress for the "Fetching files..." stage. gitref:d6e1e31a0e6[repository=src]
The {{< manpage "ctld" "8" >}} utility now supports DSCP for network QoS of the iSCSI target traffic. {{< commit "64ffe6d4409" >}}
The {{< manpage "freebsd-update" "8" >}} utility now supports the -p flag, which ensures password db changes are included in [.filename]#/etc/passwd# via {{< manpage "pwd_mkdb" "8">}}. gitref:9b6591109e8[repository=src] {{< sponsored "The FreeBSD Foundation" >}}
The {{< manpage "efibootmgr" "8" >}} utility now supports the -b flag, which lets users specify by bootnum as an index. {{< commit "a2581e80212">}} {{< sponsored "Netflix" >}}
The {{< manpage "freebsd-update" "8" >}} utility now supports the `updatesready` and `showconfig` arguments to check for updates and check the configuration respectively. gitref:8cfda118cbd[repository=src]
The {{< manpage "efibootmgr" "8" >}} utility now supports the -E flag, which lets users query which EFI System Partition was used to boot the system. {{< commit "1cdb8eb8fe1" >}}
The {{< manpage "freebsd-update" "8" >}} utility includes support for the `PAGER` environment variable, which has now been documented. gitref:32f4592764d[repository=src]
The {{< manpage "efibootmgr" "8" >}} utility now supports the -f and -F flags, which lets users tell the system to boot to the UEFI user interface or not. {{< commit "83c4237258d" >}} {{< sponsored "Ampere Computing, Inc." >}}
The {{< manpage "gstat" "8" >}} utility now documents the use of interactive keyboard commands to increase and decrease update interval as well as regular expression filters. gitref:cfaa2958dc4[repository=src]
The {{< manpage "freebsd-update" "8" >}} utility now displays progress for the "Fetching files..." stage. {{< commit "d6e1e31a0e6" >}}
The manual page for the {{< manpage "inetd" "8" >}} utility now includes an example of how to use netcat as a HTTP proxy. gitref:a58fc861516[repository=src]
The {{< manpage "freebsd-update" "8" >}} utility now supports the -p flag, which ensures password db changes are included in [.filename]#/etc/passwd# via {{< manpage "pwd_mkdb" "8">}}. {{< commit "9b6591109e8" >}} {{< sponsored "The FreeBSD Foundation" >}}
The {{< manpage "freebsd-update" "8" >}} utility now supports the [.programlisting]#updatesready# and [.programlisting]#showconfig# arguments to check for updates and check the configuration respectively. {{< commit "8cfda118cbd" >}}
The {{< manpage "freebsd-update" "8" >}} utility includes support the [.programlisting]#PAGER# environment variable, which has now been documented. {{< commit "32f4592764d" >}}
The {{< manpage "gstat" "8" >}} utility now documents the use of interactive keyboard commands to increase and decrease update interval as well as regular expression filters. {{< commit "cfaa2958dc4" >}}
The {{< manpage "inetd" "8" >}} utility now includes an example of how to use netcat as a HTTP proxy. {{< commit "a58fc861516" >}}
The {{< manpage "inetd" "8" >}} utility now includes comments for all examples. {{< commit "26a4a61a285" >}}
The {{< manpage "inetd" "8" >}} utility now includes comments for all examples. gitref:26a4a61a285[repository=src]
==== calendar: Restore calendar file condition parsing
@ -205,7 +195,9 @@ This section covers changes and additions to devices and device drivers since {r
This section covers changes and additions to file systems and other storage subsystems, both local and networked.
For {{< manpage "iscsi" "4" >}} and {{< manpage "ctld" "8" >}}, support for specifying network QoS in the form of DiffServ Codepoints (DSCP) and Ethernet Priority Code Point (PCP) was added. {{< commit "ddf1072aac49" >}} {{< sponsored "NetApp" >}}
For {{< manpage "iscsi" "4" >}} and {{< manpage "ctld" "8" >}}, support for specifying network QoS in the form of DiffServ Codepoints (DSCP) and Ethernet Priority Code Point (PCP) was added. gitref:ddf1072aac49[repository=src] {{< sponsored "NetApp" >}}
The {{< manpage "ctld" "8" >}} utility now supports the -f flag, which tests the configuration file validity. gitref:7fcbecd004f[repository=src]
[[storage-general]]
=== General Storage
@ -216,6 +208,12 @@ For {{< manpage "iscsi" "4" >}} and {{< manpage "ctld" "8" >}}, support for spec
This section covers the boot loader, boot menu, and other boot-related changes.
The {{< manpage "efibootmgr" "8" >}} utility now supports the -b flag, which lets users specify by bootnum as an index. gitref:a2581e80212[repository=src] {{< sponsored "Netflix" >}}
The {{< manpage "efibootmgr" "8" >}} utility now supports the -E flag, which lets users query which EFI System Partition was used to boot the system. gitref:1cdb8eb8fe1[repository=src]
The {{< manpage "efibootmgr" "8" >}} utility now supports the -f and -F flags, which lets users tell the system to boot to the UEFI user interface or not. gitref:83c4237258d[repository=src] {{< sponsored "Ampere Computing, Inc." >}}
[[boot-loader]]
=== Boot Loader Changes
@ -231,11 +229,11 @@ It is expected that PRR generally helps improve loss recovery performance and pr
This surpasses the prior behavior, but a strictly packet conserving variant can be enabled.
When misconfigured token bucket traffic policer can cause persistent loss even during loss recovery, activating the conservative PRR variant may prevent some retransmission timeouts (RTO) and associated session stalls for a few milliseconds while behaving less optimal in the general case.
For this, a new {{< manpage "sysctl" "8">}} was added, `net.inet.tcp.do_prr_conservative`.
Setting this variable to `1` will enable strictly packet conserving behavior (at most 1 segment for each ACK received), while the normal variant may send up to 2 segments per received ACK - helping in cases of ACK thinning or significant burst loss events. {{< commit "0e1d7c25c5ab" >}} {{< sponsored "NetApp" >}}
Setting this variable to `1` will enable strictly packet conserving behavior (at most 1 segment for each ACK received), while the normal variant may send up to 2 segments per received ACK - helping in cases of ACK thinning or significant burst loss events. gitref:0e1d7c25c5ab[repository=src] {{< sponsored "NetApp" >}}
The {{< manpage "cc_cubic" "4">}} has been improved to address various corner cases and align more closely with the standard in RFC8312. {{< commit "40f9078ff9d9" >}} {{< sponsored "NetApp" >}}
The {{< manpage "cc_cubic" "4">}} has been improved to address various corner cases and align more closely with the standard in RFC8312. gitref:40f9078ff9d9[repository=src] {{< sponsored "NetApp" >}}
The {{< manpage "ping" "8" >}} and {{< manpage "ping6" "8" >}} utilities both support setting network QoS, with IP DSCP {{< commit "6034024daddb" >}} and Ethernet PCP {{< commit "81a6f4c7ae69" >}} {{< sponsored "NetApp" >}}
The {{< manpage "ping" "8" >}} and {{< manpage "ping6" "8" >}} utilities both support setting network QoS, with IP DSCP gitref:6034024daddb[repository=src] and Ethernet PCP gitref:81a6f4c7ae69[repository=src] {{< sponsored "NetApp" >}}
[[network-general]]
=== General Network
@ -248,71 +246,71 @@ This section covers general hardware support for physical machines, hypervisors,
[[hardware-virtualization]]
=== Virtualization Support
The {{< manpage "bhyve" "8">}} utility has been updated to support COM3 and COM4 serial ports. {{< commit "eed1cc6cdfa" >}}
The {{< manpage "bhyve" "8">}} utility has been updated to support COM3 and COM4 serial ports. gitref:eed1cc6cdfa[repository=src]
The {{< manpage "bhyve" "8">}} utility has been updated to remove bvmconsole and bvmdebug now that UART support is in. {{< commit "c4df8cbfde5" >}}
The {{< manpage "bhyve" "8">}} utility has been updated to remove bvmconsole and bvmdebug now that UART support is in. gitref:c4df8cbfde5[repository=src]
The {{< manpage "bhyve" "8">}} utility now supports VNC version 3.3, has increased framebuffer poll frequency and doesn't send updates if there are no framebuffer updates. {{< commit "2bb4be0f865" >}}
The {{< manpage "bhyve" "8">}} utility now supports VNC version 3.3, has increased framebuffer poll frequency and doesn't send updates if there are no framebuffer updates. gitref:2bb4be0f865[repository=src]
The {{< manpage "bhyve" "8">}} utility now suspends I/O on ahci-cd devices during a snapshot. {{< commit "1b9c78611d9" >}}
The {{< manpage "bhyve" "8">}} utility now suspends I/O on ahci-cd devices during a snapshot. gitref:1b9c78611d9[repository=src]
The {{< manpage "bhyve" "8">}} utility now permits suspend/resume of a XHCI device model that has not been attached to by a driver in a guest OS. {{< commit "57b0a3aacad" >}}
The {{< manpage "bhyve" "8">}} utility now permits suspend/resume of a XHCI device model that has not been attached to by a driver in a guest OS. gitref:57b0a3aacad[repository=src]
The {{< manpage "bhyve" "8">}} utility now honors the disabled setting for MSI-X interrupts for passthrough devices. {{< commit "1925586e03b" >}} {{< sponsored "Chelsio Communications" >}}
The {{< manpage "bhyve" "8">}} utility now honors the disabled setting for MSI-X interrupts for passthrough devices. gitref:1925586e03b[repository=src] {{< sponsored "Chelsio Communications" >}}
The {{< manpage "bhyve" "8">}} utility now reports version 13.0 in the SMBIOS table. {{< commit "a2fe464c81d" >}}
The {{< manpage "bhyve" "8">}} utility now reports version 13.0 in the SMBIOS table. gitref:a2fe464c81d[repository=src]
The {{< manpage "bhyve" "8">}} utility now has increased the allowed size for 64bit BAR allocation below 4G from 32 to 128 MB. {{< commit "670b364b76d" >}} {{< sponsored "The FreeBSD Foundation" >}}
The {{< manpage "bhyve" "8">}} utility now has increased the allowed size for 64bit BAR allocation below 4G from 32 to 128 MB. gitref:670b364b76d[repository=src] {{< sponsored "The FreeBSD Foundation" >}}
The {{< manpage "bhyve" "8">}} utility now avoids allocating BARs above the end of supported physical addresses. {{< commit "9922872ba29" >}} {{< sponsored "The FreeBSD Foundation" >}}
The {{< manpage "bhyve" "8">}} utility now avoids allocating BARs above the end of supported physical addresses. gitref:9922872ba29[repository=src] {{< sponsored "The FreeBSD Foundation" >}}
The {{< manpage "bhyve" "8">}} utility now no longer prints non-printable characters in the smbios.chassis.maker and smbios.system.maker OIDs. {{< commit "c4fd0cc9ee2" >}} {{< sponsored "Netflix" >}}
The {{< manpage "bhyve" "8">}} utility now no longer prints non-printable characters in the smbios.chassis.maker and smbios.system.maker OIDs. gitref:c4fd0cc9ee2[repository=src] {{< sponsored "Netflix" >}}
The {{< manpage "bhyve" "8">}} utility now supports TRIM via the VirtIO block device. {{< commit "22769bbe30b" >}} {{< sponsored "Klara Inc." >}}
The {{< manpage "bhyve" "8">}} utility now supports TRIM via the VirtIO block device. gitref:22769bbe30b[repository=src] {{< sponsored "Klara Inc." >}}
The {{< manpage "bhyve" "8">}} utility now supports TRIM alignment requirements through VirtIO. {{< commit "cc3568c1d06" >}} {{< sponsored "vStack.com" >}}
The {{< manpage "bhyve" "8">}} utility now supports TRIM alignment requirements through VirtIO. gitref:cc3568c1d06[repository=src] {{< sponsored "vStack.com" >}}
The {{< manpage "bhyve" "8">}} utility now supports virtio-9p (aka VirtFS) filesystem sharing. {{< commit "100353cfbf8" >}} {{< sponsored "Conclusive Engineering (development), vStack.com (funding)" >}}
The {{< manpage "bhyve" "8">}} utility now supports virtio-9p (aka VirtFS) filesystem sharing. gitref:100353cfbf8[repository=src] {{< sponsored "Conclusive Engineering (development), vStack.com (funding)" >}}
The {{< manpage "bhyve" "8">}} utility now reports nominal health values for NVMe. {{< commit "c4a86c1fc0d" >}}
The {{< manpage "bhyve" "8">}} utility now reports nominal health values for NVMe. gitref:c4a86c1fc0d[repository=src]
The {{< manpage "bhyve" "8">}} utility now supports LA57 guest mode. {{< sponsored "f3eb12e4a6d" >}} {{< sponsored "The FreeBSD Foundation" >}}
The {{< manpage "bhyve" "8">}} utility now supports LA57 guest mode. gitref:f3eb12e4a6d[repository=src] {{< sponsored "The FreeBSD Foundation" >}}
The {{< manpage "bhyve" "8">}} utility now supports setting additional AHCI controller parameters like serial number, firmware revision, model number and NMRR. {{< commit "9af3bcd7c97" >}}
The {{< manpage "bhyve" "8">}} utility now supports setting additional AHCI controller parameters like serial number, firmware revision, model number and NMRR. gitref:9af3bcd7c97[repository=src]
The {{< manpage "bhyve" "8">}} utility now advertises 64-bit physical-address capability. {{< commit "fb5f5a17ef0" >}}
The {{< manpage "bhyve" "8">}} utility now advertises 64-bit physical-address capability. gitref:fb5f5a17ef0[repository=src]
The {{< manpage "bhyve" "8">}} utility no longer sends ACPI RTC errors/warnings in some guests. {{< commit "6a7ff0600bb" >}}
The {{< manpage "bhyve" "8">}} utility no longer sends ACPI RTC errors/warnings in some guests. gitref:6a7ff0600bb[repository=src]
The {{< manpage "bhyve" "8">}} utility now supports NVMe Feature Interrupt Vector Config, Firmware Commit, Asyncronous Event Requests, SMART data I/O statistics, NVMe Format NVM commands, NVMe Namespace Identification Descriptor, the NVMe deallocate command and the NVMe Flush command in a series of commits.
The {{< manpage "bhyve" "8">}} utility now allows for automatic destruction on power-off. {{< commit "0a1016f9e8a" >}} {{< sponsored "Mysterious Code Ltd." >}}
The {{< manpage "bhyve" "8">}} utility now allows for automatic destruction on power-off. gitref:0a1016f9e8a[repository=src] {{< sponsored "Mysterious Code Ltd." >}}
The {{< manpage "bhyve" "8">}} utility now exposes kernel-emulated special devices like LAPIC, IOAPIC, and HPET devices to userspace. {{< commit "8a68ae80f67" >}}
The {{< manpage "bhyve" "8">}} utility now exposes kernel-emulated special devices like LAPIC, IOAPIC, and HPET devices to userspace. gitref:8a68ae80f67[repository=src] >}}
The {{< manpage "bhyve" "8">}} utility now supports a new bhyve network backend that allow connecting the VM to the {{< manpage "netgraph" "4">}} network. {{< commit "2cd7735d920" >}} {{< sponsored "vStack.com" >}}
The {{< manpage "bhyve" "8">}} utility now supports a new bhyve network backend that allow connecting the VM to the {{< manpage "netgraph" "4">}} network. gitref:2cd7735d920[repository=src] {{< sponsored "vStack.com" >}}
The {{< manpage "bhyve" "8">}} utility now has initial support for bhyve save and restore. {{< commit "483d953a86a" >}} {{< sponsored "University Politehnica of Bucharest, Matthew Grooms (student scholarships), iXsystems" >}}
The {{< manpage "bhyve" "8">}} utility now has initial support for bhyve save and restore. gitref:483d953a86a[repository=src] {{< sponsored "University Politehnica of Bucharest, Matthew Grooms (student scholarships), iXsystems" >}}
The {{< manpage "bhyve" "8">}} utility now supports the VM Generation Counter ACPI device. {{< commit "9cb339cc7b8" >}}
The {{< manpage "bhyve" "8">}} utility now supports the VM Generation Counter ACPI device. gitref:9cb339cc7b8[repository=src]
The {{< manpage "bhyve" "8">}} utility has had multiple changes done to the VirtIO network device, like adjustable MTU, mergeable rx buffers, rx backpressure and enabling/disabling VirtIO network device in a series of commits.
The {{< manpage "bhyve" "8">}} utility now supports the Hygon Dhyana x86 CPU. {{< commit "5a6d45d0150" >}}
The {{< manpage "bhyve" "8">}} utility now supports the Hygon Dhyana x86 CPU. gitref:5a6d45d0150[repository=src]
The {{< manpage "bhyve" "8">}} utility now supports software breakpoints in the debug server on Intel CPUs. {{< commit "cbd03a9df2c" >}}
The {{< manpage "bhyve" "8">}} utility now supports software breakpoints in the debug server on Intel CPUs. gitref:cbd03a9df2c[repository=src]
The {{< manpage "bhyve" "8">}} utility now PCI HDAudio device. {{< commit "7e3c7420615" >}}
The {{< manpage "bhyve" "8">}} utility now PCI HDAudio device. gitref:7e3c7420615[repository=src]
The {{< manpage "bhyve" "8">}} utility now supports the PCIe Integrated Endpoint capability. {{< commit "129f93c5a76" >}}
The {{< manpage "bhyve" "8">}} utility now supports the PCIe Integrated Endpoint capability. gitref:129f93c5a76[repository=src]
The {{< manpage "bhyve" "8">}} utility is now SMBIOS table topology aware. {{< commit "3facfc75607" >}}
The {{< manpage "bhyve" "8">}} utility is now SMBIOS table topology aware. gitref:3facfc75607[repository=src]
The {{< manpage "bhyve" "8">}} utility now supports CTL device specification via the VirtIO SCSI device. {{< commit "49f8782283d" >}} {{< sponsored "iXsystems, Inc." >}}
The {{< manpage "bhyve" "8">}} utility now supports CTL device specification via the VirtIO SCSI device. gitref:49f8782283d[repository=src] {{< sponsored "iXsystems, Inc." >}}
The {{< manpage "bhyve" "8">}} utility now supports PS/2 scancodes for NumLock, ScrollLock and numerical keypad keys. {{< commit "6f2d76643e6" >}} {{< sponsored "iXsystems Inc." >}}
The {{< manpage "bhyve" "8">}} utility now supports PS/2 scancodes for NumLock, ScrollLock and numerical keypad keys. gitref:6f2d76643e6[repository=src] {{< sponsored "iXsystems Inc." >}}
The {{< manpage "bhyve" "8">}} utility now supports the VNC server to listen on IPv6 for incoming connections. {{< commit "8883128b8e9" >}}
The {{< manpage "bhyve" "8">}} utility now supports the VNC server to listen on IPv6 for incoming connections. gitref:8883128b8e9[repository=src]
In addition to all of these, bhyve received an amount of minor changes, which are too numerous to mention, and which fixes a number of outstanding issues.

1
website/themes/beastie/layouts/shortcodes/commit.html
View file

@ -1 +0,0 @@
<a href="https://cgit.freebsd.org/src/commit/?id={{ .Get 0 }}">[{{ .Get 0 }}]</a>