git: d46632e1af - main - Fix links to the handbook in FAQ
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Sun, 04 Sep 2022 10:30:37 UTC
The branch main has been updated by carlavilla:
URL: https://cgit.FreeBSD.org/doc/commit/?id=d46632e1af2002089721a751d7655401f513fe43
commit d46632e1af2002089721a751d7655401f513fe43
Author: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2022-09-04 10:29:12 +0000
Commit: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2022-09-04 10:30:29 +0000
Fix links to the handbook in FAQ
PR: 259342, 266107
Submitted by: grahamperrin@, mhorne@
---
documentation/content/en/books/faq/_index.adoc | 76 +++++++++++++-------------
1 file changed, 38 insertions(+), 38 deletions(-)
diff --git a/documentation/content/en/books/faq/_index.adoc b/documentation/content/en/books/faq/_index.adoc
index 3115aeaf84..5ea65360d4 100644
--- a/documentation/content/en/books/faq/_index.adoc
+++ b/documentation/content/en/books/faq/_index.adoc
@@ -170,9 +170,9 @@ More information on FreeBSD releases can be found on the https://www.FreeBSD.org
[[current]]
=== What is _FreeBSD-CURRENT_?
-extref:{handbook}[FreeBSD-CURRENT, current] is the development version of the operating system, which will in due course become the new FreeBSD-STABLE branch.
+extref:{handbook}cutting-edge/[FreeBSD-CURRENT, current] is the development version of the operating system, which will in due course become the new FreeBSD-STABLE branch.
As such, it is really only of interest to developers working on the system and die-hard hobbyists.
-See the extref:{handbook}[relevant section, current] in the extref:{handbook}[Handbook] for details on running _-CURRENT_.
+See the extref:{handbook}cutting-edge/[relevant section, current] in the extref:{handbook}[Handbook] for details on running _-CURRENT_.
Users not familiar with FreeBSD should not use FreeBSD-CURRENT.
This branch sometimes evolves quite quickly and due to mistake can be un-buildable at times.
@@ -390,7 +390,7 @@ The main one is called [.filename]#index.html#, which will contain the table of
[[mailing]]
=== Where do I find info on the FreeBSD mailing lists? What FreeBSD news groups are available?
-Refer to the extref:{handbook}[Handbook entry on mailing-lists, eresources-mail] and the extref:{handbook}[Handbook entry on newsgroups, eresources-news].
+Refer to the extref:{handbook}eresources/[Handbook entry on mailing-lists, eresources-mail] and the extref:{handbook}eresources/[Handbook entry on newsgroups, eresources-news].
[[irc]]
=== Are there FreeBSD IRC (Internet Relay Chat) channels?
@@ -470,7 +470,7 @@ When using a command line FTP client, type _binary_ at the FTP command prompt af
[[install-instructions-location]]
=== Where are the instructions for installing FreeBSD?
-Installation instructions can be found at extref:{handbook}[Handbook entry on installing FreeBSD, bsdinstall].
+Installation instructions can be found at extref:{handbook}bsdinstall/[Handbook entry on installing FreeBSD].
[[custom-boot-floppy]]
=== How can I make my own custom release or install disk?
@@ -841,7 +841,7 @@ The number is based on the `kern.maxusers` man:sysctl[8] variable.
If the machine is heavily loaded, increase `kern.maxusers`.
This will increase these other system limits in addition to the maximum number of processes.
-To adjust the `kern.maxusers` value, see the extref:{handbook}[File/Process Limits, kern-maxfiles] section of the Handbook.
+To adjust the `kern.maxusers` value, see the extref:{handbook}config/[File/Process Limits, kern-maxfiles] section of the Handbook.
While that section refers to open files, the same limits apply to processes.
If the machine is lightly loaded but running a very large number of processes, adjust the `kern.maxproc` tunable by defining it in [.filename]#/boot/loader.conf#.
@@ -895,7 +895,7 @@ If this is causing the problem, either fill in the missing information in [.file
=== Why does file: table is full show up repeatedly in man:dmesg[8]?
This error message indicates that the number of available file descriptors have been exhausted on the system.
-Refer to the extref:{handbook}[kern.maxfiles, kern-maxfiles] section of the extref:{handbook}[Tuning Kernel Limits, configtuning-kernel-limits] section of the Handbook for a discussion and solution.
+Refer to the extref:{handbook}config/[kern.maxfiles, kern-maxfiles] section of the extref:{handbook}config/[Tuning Kernel Limits, configtuning-kernel-limits] section of the Handbook for a discussion and solution.
[[computer-clock-skew]]
=== Why does the clock on my computer keep incorrect time?
@@ -1023,12 +1023,12 @@ Use man:pkg[7] to control the installation of packages.
[[how-do-download-ports-tree]]
=== How do I download the Ports tree? Should I be using Git?
-See crossref:handbook[ports-using-installation-methods,Installing the Ports Collection].
+See extref:{handbook}ports/[Installing the Ports Collection, ports-using-installation-methods]
[[ports-4x]]
=== Why can I not build this port on my {rel2-relx} -, or {rel-relx} -STABLE machine?
-If the installed FreeBSD version lags significantly behind _-CURRENT_ or _-STABLE_, update the Ports Collection using the instructions in extref:{handbook}[Using the Ports Collection, ports-using].
+If the installed FreeBSD version lags significantly behind _-CURRENT_ or _-STABLE_, update the Ports Collection using the instructions in extref:{handbook}ports/[Using the Ports Collection, ports-using].
If the system is up-to-date, someone might have committed a change to the port which works for _-CURRENT_ but which broke the port for _-STABLE_.
https://bugs.FreeBSD.org/submit/[Submit] a bug report, since the Ports Collection is supposed to work for both the _-CURRENT_ and _-STABLE_ branches.
@@ -1045,7 +1045,7 @@ If you suspect that this is the case, try to make [.filename]#INDEX# with those
=== I updated the sources, now how do I update my installed ports?
FreeBSD does not include a port upgrading tool, but it does have some tools to make the upgrade process somewhat easier.
-Additional tools are available to simplify port handling and are described the extref:{handbook}[Upgrading Ports, ports-using] section in the FreeBSD Handbook.
+Additional tools are available to simplify port handling and are described the extref:{handbook}ports/[Upgrading Ports, ports-using] section in the FreeBSD Handbook.
[[ports-major-upgrade]]
=== Do I need to recompile every port each time I perform a major version update?
@@ -1056,7 +1056,7 @@ things will randomly crash and fail to work once other ports are installed or up
When the system is upgraded, various shared libraries, loadable modules, and other parts of the system will be replaced with newer versions.
Applications linked against the older versions may fail to start or, in other cases, fail to function properly.
-For more information, see extref:{handbook}[the section on upgrades, freebsdupdate-upgrade] in the FreeBSD Handbook.
+For more information, see extref:{handbook}cutting-edge/[the section on upgrades, freebsdupdate-upgrade] in the FreeBSD Handbook.
[[ports-minor-upgrade]]
=== Do I need to recompile every port each time I perform a minor version update?
@@ -1083,7 +1083,7 @@ Compare the memory utilization of these shells by looking at the "VSZ" and "RSS"
[[make-kernel]]
=== I would like to customize my kernel. Is it difficult?
-Not at all! Check out the extref:{handbook}[kernel config section of the Handbook, kernelconfig].
+Not at all! Check out the extref:{handbook}kernelconfig/[kernel config section of the Handbook].
[NOTE]
====
@@ -1140,7 +1140,7 @@ For more information, read [.filename]#/usr/share/examples/etc/make.conf#.
Unneeded devices can be removed from the kernel to further reduce the size.
See <<make-kernel>> for more information.
-To put any of these options into effect, follow the instructions to extref:{handbook}[build and install, kernelconfig-building] the new kernel.
+To put any of these options into effect, follow the instructions to extref:{handbook}kernelconfig/[build and install, kernelconfig-building] the new kernel.
For reference, the FreeBSD 11 amd64 kernel ([.filename]#/boot/kernel/kernel#) is approximately 25 MB.
@@ -1175,7 +1175,7 @@ kern.sched.name: ULE
[[adding-disks]]
=== How can I add my new hard disk to my FreeBSD system?
-See the extref:{handbook}[Adding Disks, disks-adding] section in the FreeBSD Handbook.
+See the extref:{handbook}disks/[Adding Disks, disks-adding] section in the FreeBSD Handbook.
[[new-huge-disk]]
=== How do I move my system over to my huge new disk?
@@ -1323,7 +1323,7 @@ there will be a device file for "slice 5" in [.filename]#/dev#. To mount it:
=== Is there a cryptographic file system for FreeBSD?
Yes, man:gbde[8] and man:geli[8].
-See the extref:{handbook}[Encrypting Disk Partitions, disks-encrypting] section of the FreeBSD Handbook.
+See the extref:{handbook}disks/[Encrypting Disk Partitions, disks-encrypting] section of the FreeBSD Handbook.
[[grub-loader]]
=== How do I boot FreeBSD and Linux(R) using GRUB?
@@ -1402,31 +1402,31 @@ It is a good idea to add a line to [.filename]#/etc/fstab# (see man:fstab[5]) so
=== Why do I get Incorrect super block when mounting a CD?
The type of device to mount must be specified.
-This is described in the Handbook section on extref:{handbook}[Using Data CDs, mounting-cd].
+This is described in the Handbook section on extref:{handbook}disks/[Using Data CDs, mounting-cd].
[[cdrom-not-configured]]
=== Why do I get Device not configured when mounting a CD?
This generally means that there is no CD in the drive, or the drive is not visible on the bus.
-Refer to the extref:{handbook}[Using Data CDs, mounting-cd] section of the Handbook for a detailed discussion of this issue.
+Refer to the extref:{handbook}disks/[Using Data CDs, mounting-cd] section of the Handbook for a detailed discussion of this issue.
[[cdrom-unicode-filenames]]
=== Why do all non-English characters in filenames show up as ? on my CDs when mounted in FreeBSD?
The CD probably uses the "Joliet" extension for storing information about files and directories.
-This is discussed in the Handbook section on extref:{handbook}[Using Data CD-ROMs, mounting-cd].
+This is discussed in the Handbook section on extref:{handbook}disks/[Using Data CD-ROMs, mounting-cd].
[[burncd-isofs]]
=== A CD burned under FreeBSD cannot be read under any other operating system. Why?
This means a raw file was burned to the CD, rather than creating an ISO 9660 file system.
-Take a look at the Handbook section on extref:{handbook}[Using Data CDs].
+Take a look at the Handbook section on extref:{handbook}disks/[Using Data CDs].
[[copy-cd]]
=== How can I create an image of a data CD?
-This is discussed in the Handbook section on extref:{handbook}[Writing Data to an ISO File System, mkisofs].
-For more on working with CD-ROMs, see the extref:{handbook}[Creating CDs Section, creating-cds] in the Storage chapter in the Handbook.
+This is discussed in the Handbook section on extref:{handbook}disks/[Writing Data to an ISO File System, mkisofs].
+For more on working with CD-ROMs, see the extref:{handbook}disks/[Creating CDs Section, creating-cds] in the Storage chapter in the Handbook.
[[mount-audio-CD]]
=== Why can I not mount an audio CD?
@@ -1518,7 +1518,7 @@ Note that Soft Updates can delay the freeing of disk space and it can take up to
[[add-swap-space]]
=== How can I add more swap space?
-This section extref:{handbook}[of the Handbook, adding-swap-space] describes how to do this.
+This section extref:{handbook}config/[of the Handbook, adding-swap-space] describes how to do this.
[[manufacturer-disk-size]]
=== Why does FreeBSD see my disk as smaller than the manufacturer says it is?
@@ -1708,13 +1708,13 @@ The error message displayed immediately after the kernel boot messages should in
[[printer-setup]]
=== Why am I having trouble setting up my printer?
-See the extref:{handbook}[Handbook entry on printing, printing] for troubleshooting tips.
+See the extref:{handbook}printing/[Handbook entry on printing] for troubleshooting tips.
[[keyboard-mappings]]
=== How can I correct the keyboard mappings for my system?
-Refer to the Handbook section on extref:{handbook}[using localization, using-localization],
-specifically the section on extref:{handbook}[console setup, setting-console].
+Refer to the Handbook section on extref:{handbook}l10n/[using localization, using-localization],
+specifically the section on extref:{handbook}l10n/[console setup, setting-console].
[[user-quotas]]
=== Why can I not get user quotas to work properly?
@@ -1727,7 +1727,7 @@ In this case, add the following line to the kernel configuration file and recomp
options QUOTA
....
+
-Refer to the extref:{handbook}[Handbook entry on quotas, quotas] for full details.
+Refer to the extref:{handbook}disks/[Handbook entry on quotas, quotas] for full details.
. Do not turn on quotas on [.filename]#/#.
. Put the quota file on the file system that the quotas are to be enforced on:
+
@@ -1790,7 +1790,7 @@ For example, replace `mount -urw /` with `mount /dev/ada0p1 /mnt; chroot /mnt` f
====
If the root partition cannot be mounted from single-user mode,
it is possible that the partitions are encrypted and it is impossible to mount them without the access keys.
-For more information see the section about encrypted disks in the FreeBSD extref:{handbook}[Handbook, disks-encrypting].
+For more information see the section about encrypted disks in the FreeBSD extref:{handbook}disks/[Handbook, disks-encrypting].
====
[[CAD-reboot]]
@@ -2005,7 +2005,7 @@ Install Xorg from FreeBSD packages:
# pkg install xorg
....
-After the installation of Xorg, follow the instructions from the extref:{handbook}[X11 Configuration, x-config] section of the FreeBSD Handbook.
+After the installation of Xorg, follow the instructions from the extref:{handbook}x11/[X11 Configuration, x-config] section of the FreeBSD Handbook.
[[running-X-securelevels]]
=== I tried to run X, but I get a No devices detected. error when I type startx. What do I do now?
@@ -2330,18 +2330,18 @@ For ATI Rage 128 and Radeon see man:ati[4], man:r128[4] and man:radeon[4].
=== Where can I get information on diskless booting?
"Diskless booting" means that the FreeBSD box is booted over a network, and reads the necessary files from a server instead of its hard disk.
-For full details, see extref:{handbook}[the Handbook entry on diskless booting, network-diskless].
+For full details, see extref:{handbook}advanced-networking/[the Handbook entry on diskless booting, network-diskless].
[[router]]
=== Can a FreeBSD box be used as a dedicated network router?
-Yes. Refer to the Handbook entry on extref:{handbook}[advanced networking, advanced-networking],
-specifically the section on extref:{handbook}[routing and gateways, network-routing].
+Yes. Refer to the Handbook entry on extref:{handbook}advanced-networking/[advanced networking, advanced-networking],
+specifically the section on extref:{handbook}advanced-networking/[routing and gateways, network-routing].
[[natd]]
=== Does FreeBSD support NAT or Masquerading?
-Yes. For instructions on how to use NAT over a PPP connection, see the extref:{handbook}[Handbook entry on PPP, userppp].
+Yes. For instructions on how to use NAT over a PPP connection, see the extref:{handbook}ppp-and-slip/[Handbook entry on PPP, userppp].
To use NAT over some other sort of network connection, look at the extref:{handbook}[natd, network-natd] section of the Handbook.
[[ethernet-aliases]]
@@ -2361,7 +2361,7 @@ Otherwise, specify the network address and netmask as usual:
# ifconfig ed0 alias 172.16.141.5 netmask 0xffffff00
....
-More information can be found in the FreeBSD extref:{handbook}[Handbook, configtuning-virtual-hosts].
+More information can be found in the FreeBSD extref:{handbook}config/[Handbook, configtuning-virtual-hosts].
[[nfs-linux]]
=== Why can I not NFS-mount from a Linux(R) box?
@@ -2377,7 +2377,7 @@ Some versions of the Linux(R) NFS code only accept mount requests from a privile
=== Why does mountd keep telling me it can't change attributes and that I have a bad exports list on my FreeBSD NFS server?
The most frequent problem is not understanding the correct format of [.filename]#/etc/exports#.
-Review man:exports[5] and the extref:{handbook}[NFS, network-nfs] entry in the Handbook,
+Review man:exports[5] and the extref:{handbook}network-servers/[NFS, network-nfs] entry in the Handbook,
especially the section on extref:{handbook}[configuring NFS, configuring-nfs].
[[ip-multicast]]
@@ -2388,7 +2388,7 @@ Install the package:net/mrouted[] package or port and add `mrouted_enable="YES"`
[[fqdn-hosts]]
=== Why do I have to use the FQDN for hosts on my site?
-See the answer in the FreeBSD extref:{handbook}[Handbook, mail-trouble].
+See the answer in the FreeBSD extref:{handbook}mail/[Handbook, mail-trouble].
[[network-permission-denied]]
=== Why do I get an error, Permission denied, for all networking operations?
@@ -2405,7 +2405,7 @@ If the firewall is unintentionally misconfigured, restore network operability by
Consider setting `firewall_type="open"` in [.filename]#/etc/rc.conf#.
-For further information on configuring this firewall, see the extref:{handbook}[Handbook chapter, firewalls-ipfw].
+For further information on configuring this firewall, see the extref:{handbook}firewalls/[Handbook chapter, firewalls-ipfw].
[[ipfw-fwd]]
=== Why is my `ipfw` “fwd” rule to redirect a service to another machine not working?
@@ -2632,7 +2632,7 @@ This section answers common questions about serial communications with FreeBSD.
[[serial-console-prompt]]
=== How do I get the boot: prompt to show on the serial console?
-See extref:{handbook}[this section of the Handbook, serialconsole-setup].
+See extref:{handbook}serialcomms/[this section of the Handbook, serialconsole-setup].
[[found-serial]]
=== How do I tell if FreeBSD found my serial ports or modem cards?
@@ -2707,7 +2707,7 @@ The flags indicate that the master port has minor number `7` (`0x700`), and all
[[default-serial-params]]
=== Can I set the default serial parameters for a port?
-See the extref:{handbook}serialcomms[Serial Communications, serial-hw-config] section in the FreeBSD Handbook.
+See the extref:{handbook}serialcomms/[Serial Communications, serial-hw-config] section in the FreeBSD Handbook.
[[cannot-tip]]
=== Why can I not run tip or cu?
@@ -2848,7 +2848,7 @@ Xfig and eps drawings are available under [.filename]#/usr/share/examples/BSD_da
[[glossary]]
=== I have seen an acronym or other term on the mailing lists and I do not understand what it means. Where should I look?
-Refer to the extref:{handbook}[FreeBSD Glossary, freebsd-glossary].
+Refer to the extref:{handbook}glossary/[FreeBSD Glossary].
[[bikeshed-painting]]
=== Why should I care what color the bikeshed is?