aboutsummaryrefslogtreecommitdiff
path: root/documentation/content/en/books/handbook/config
Commit message (Collapse)AuthorAgeFilesLines
* doc: Update source files (en .po), for translationsDanilo G. Baio2025-05-011-544/+546
|
* [documentation]: Fix front matter "path" parameter.Fernando Apesteguía2025-02-181-1/+2
| | | | | | | | "path:" parameter in the front matter was not documented and it has been deprecated in gohugo 0.144.0. Create a custom parameter with the same name in preparation for the upcoming update of www/gohugo to 0.144.1
* Regenerate translation filesEd Maste2024-12-291-5/+5
| | | | | | | | Via `sh tools/update_translate_template.sh documentation` Reviewed by: dbaio Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D48234
* [documentation]: Fix more linksFernando Apesteguía2024-09-231-1/+1
| | | | | | | * Add description for some missing crossref macros. * Remove a couple of dangling anchors * Remove spurious '.' at the beginning of some descriptions * Fix misspelled macro name
* Fix links that use crossref without descriptionFernando Apesteguía2024-09-221-2/+2
| | | | | | | | | | | | | Summary: Add the anchor text to the crossref macro Test Plan: Apply patch and build the documentation A follow-up change will make the crossref macro fail if no description is used. Subscribers: delphij Differential Revision: https://reviews.freebsd.org/D46721
* doc: Update source files (en .po), for translationsDanilo G. Baio2024-09-141-462/+472
|
* [documentation]: Fix links in all output formatsFernando Apesteguía2024-09-071-3/+7
| | | | | | | | | | | | | Use the crossref: macro for intra-file and intra-book links. This will produce the correct link in Single HTML, Splitted HTML and PDF. Rework the macro to include the PDF special render. While here, briefly document macros. PR: 266107 Reviewed by: bcr@, dbaio@, concussious.bugzilla_runbox.com Differential Revision: https://reviews.freebsd.org/D46480
* rc services: add docs for automatic service jails (new in 15-current)Alexander Leidinger2024-05-221-0/+2
| | | | | Reviewed by: bcr, fernape Differential Revision: https://reviews.freebsd.org/D42779
* documentation: Adjust path variables for Hugo 0.123.X upgradeDanilo G. Baio2024-03-231-1/+1
| | | | | | | | These adjustments ensure menu and navigation will work fine with the recent changes. Reviewed by: fernape Differential Revision: https://reviews.freebsd.org/D44284
* handbook: Remove $FreeBSD$ tags from some examplesGordon Bergling2024-03-141-4/+1
| | | | | Remove $FreeBSD$ tags in some examples in the configuration, disk and mail chapters.
* handbook/config: Fix cpufreq man linkViacheslav Chimishuk2024-01-171-1/+1
| | | | | Reviewed by: Mina Galić <freebsd@igalic.co>, dbaio Pull Request: https://github.com/freebsd/freebsd-doc/pull/330
* doc: Update source files (en .po), for translationsDanilo G. Baio2024-01-171-110/+126
|
* [hb][config]: Mention backlight(9)Fernando Apesteguía2023-11-141-0/+12
| | | | Add a mention to backlight(9) and backlight(8) in the configuration chapter.
* doc: Update source files (en .po), for translationsDanilo G. Baio2023-09-091-1791/+2059
|
* Handbook - Config: Add cpu frequency control sectionKyle Kneisl2023-08-121-0/+77
| | | | | | Differential Revision: https://reviews.freebsd.org/D30004 Reviewed by: allanjude@, bcr@, debdrup@, carlavilla@, Pau Amma <pauamma@gundo.com> Approved by: kib@, gjb@
* Handbook-WG: Upgrade config chapterSergio Carlavilla Delgado2023-08-011-855/+844
| | | | | | | | | | | | | | | | | | | | | | | | | | | Changes: * Change the title of the chapter to be more acurate * Add a config files entry (/etc, /usr/local/etc), and /etc/sysctl.conf * Rework the entry "managing services in FreeBSD" * Upgrade cron section and add periodic info * Upgrade syslog section * Remove tuning section, some parts are really outdated * Upgrade power management section * Little upgrades to swap section ACPI info obtained from: * https://freebsdfoundation.org/wp-content/uploads/2022/04/ACPI-Support-for-Embedded-Controllers.pdf * https://freebsdfoundation.org/wp-content/uploads/2018/04/Pain-and-Suffering-on-the-Road-to-Resume.pdf * https://wiki.freebsd.org/ACPI * https://papers.freebsd.org/2002/watanabe-acpi.files/watanabe-acpi-paper.pdf * https://vermaden.wordpress.com/2018/11/28/the-power-to-serve-freebsd-power-management/ * https://github.com/freebsd/drm-kmod/blob/master/drivers/gpu/drm/i915/i915_params.c PR: 219953,260994,216753 Differential Revision: https://reviews.freebsd.org/D41052 Reviewed by: fernape, karels Sponsored by: Daifressh
* doc: Update source files (en .po), for translationsDanilo G. Baio2023-07-151-1298/+368
|
* Handbook WG - Create a new network chapterSergio Carlavilla Delgado2023-07-061-483/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | Create a new chaper with the basic configuration of a wired and wireless networks in FreeBSD. Sections of the new chapter: - Synopsis - Setting up the Network - Wired Networks - Wireless Networks - Hostname - DNS - Troubleshooting Changes: - Move wired network section from config to network - Move virtual hosts section from config to advanced networking - Move basic wireless section from advanced networking to network - Move IPv6 from advanced networking to network - Upgrade all command outputs - Use sysrc - Improve AsciiDoc syntax Differential Revision: https://reviews.freebsd.org/D40546 Reviewed by: bcr, dbaio, fernape, karels Sponsored by: Daifressh
* doc: Update source files (en .po), for translationsDanilo G. Baio2023-05-211-324/+323
|
* FreeBSD Handbook: Config…: ACPI SpecificationGraham Perrin2023-05-042-3/+2
| | | | | | | | | 2.0 is outdated. acpi.info is not found. Instead: https://uefi.org/specifications#ACPI where version 6.5 is current, and the oldest is 5.0 (Errata B) (released August 2014).
* FreeBSD Handbook: Config… and Tuning: correctionsGraham Perrin2023-05-041-6/+10
| | | | | | | | | | | | Minor corrections. Names of some mailing lists lacked the 'the' prefix. If referring to an outdated/legacy list archive, without mentioning that it is not current: also, refer to the current archive. One sentence per line should apply to most areas where a question mark is followed by a space.
* doc: Update source files (en .po), for translationsDanilo G. Baio2023-04-201-480/+480
|
* Remove useless Hugo alias in HandbookSergio Carlavilla Delgado2023-03-041-1/+0
|
* doc: Update source files (en .po), for translationsDanilo G. Baio2023-01-211-5/+5
|
* Escape correctly the # character and fix some typosLuís Henriques2022-11-021-1/+1
| | | | PR: 267002
* Move wayland section to its own chapterSergio Carlavilla Delgado2022-11-021-3/+3
| | | | | | | | No changes, only move the content from X11 to a new chapter Patch by: trhodes@, with some minor changes from carlavilla@ Differential Revision: https://reviews.freebsd.org/D35099
* handbook: Update source files (en .po), for translationsDanilo G. Baio2022-10-011-480/+480
|
* handbook: Adjust YAML/aliases in the Front MatterDanilo G. Baio2022-10-011-14/+1
| | | | | | | | | | | | The aliases tags are valid YAML, but the po4a tool is not prepared to identify them. This change works around the issue until we have a proper fix on po4a. These aliases tags were introduced recently to improve SEO in the Handbook. Discussed with: carlavilla
* Add hugo aliases to improve SEO in the HandbookSergio Carlavilla Delgado2022-09-021-0/+14
|
* doc: Add source .po files for translationsDanilo G. Baio2022-08-071-0/+4026
| | | | | | | | | | | | | | | | | | This helps the Weblate translation workflow and offline translations through .po files, it's important to update these files constantly. The goal here is to have a semi-automated translation workflow; Weblate will pull updates automatically from the main repository and commit translations to another repository. Doc committers are encouraged to update the source .po files whenever there are updates in the English documentation part. $ ./tools/update_translate_template.sh documentation Anyway, I'll keep doing this periodically. Discussed with: doceng
* Remove references to net.inet.tcp.inflight*Mateusz Piotrowski2022-05-241-20/+0
| | | | | | | Those variables were removed over 12 years ago. See the 1c18314d17c6ce5 ("Remove the TCP inflight bandwidth limiter...") commit in the src tree.
* New Documentation PortalSergio Carlavilla Delgado2021-12-111-0/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | I'm very pleased to announce the release of our new Documentation Portal. Key features: * Responsive * Modern design * Theme support: Light, Dark, High contrast * Removed Python dependency Acknowledgment: * Alexander Leidinger <netchild (at) FreeBSD.org> * Baptiste Daroussin <bapt (at) FreeBSD.org> * Benedict Reuschling <bcr (at) freebsd.org> * Daniel Ebdrup Jensen <debdrup (at) FreeBSD.org> * Danilo G. Baio <dbaio (at) FreeBSD.org> * Dave Cottlehuber <dch (at) FreeBSD.org> * Ed Maste <emaste (at) FreeBSD.org> * Fernando Apesteguía <fernape (at) FreeBSD.org> * Pedro Giffuni <pfg (at) FreeBSD.org> * Joseph Mingrone <jrm (at) ftfl.ca> * Rocky Hotas <rockyhotas (at) firemail.cc> * Pau Amma <pauamma (at) gundo.com> * The FreeBSD Foundation Approved by: core, doceng
* Build offline documentation using Hugo and other improvementsSergio Carlavilla Delgado2021-11-031-20/+22
| | | | | | | | | | | | | | | | | | | | | | * Allow to build the documentation offline using Hugo * Fix link problems * Remove SVN entities * Fix lang problems to help weblate * Move all the AsciiDoctor translations to the shared folder to help weblate * Allow the possibility to build each document. For example each document can be edited in and watched the result in real time in VS Code or Vim/NeoVim. Breaking changes: Eliminate the possibility of building books or articles. They must be builded at the same time. This functionality will be restored when version 0.89.0 is in the repositories in a couple of weeks. Reviewed by: dbaio@ Differential Revision: https://reviews.freebsd.org/D31926
* Revert "Add Hugo's lang shortcode"Danilo G. Baio2021-06-191-3/+3
| | | | | | | This reverts commit 3462d12db6ebf303064db168a2333374344f369a. Too soon, it broke asciidoctor-pdf which doesn't know Hugo's shortcode. It will take more time and care.
* Add Hugo's lang shortcodeDanilo G. Baio2021-06-191-3/+3
| | | | | | | | | | | | | | | | | | This is a prerequisite for the translation workflow through .po files and Weblate. The asciidoctor include with the shortcode variable will help because won't be needed to change the includes manually after converting the translation (.po file) back to .adoc. It will help other areas like, language attributes, which today is fixed in every document. The use of shortcode was suggested by jmooring@ from Hugo's project on Github. Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D30823
* handbook: No need to specify the md device number, so don't.Ceri Davies2021-06-141-2/+1
|
* Use One Sentence Per Line in the HandbookSergio Carlavilla Delgado2021-06-061-203/+648
|
* Improve SEO with the keywors meta tagSergio Carlavilla Delgado2021-05-041-0/+1
| | | | | | Add in all articles and books the tag list. Modify the theme to use the tag list defined in articles and books to generate the keywords meta tag
* Improve the SEO of the documentation portalSergio Carlavilla Delgado2021-05-011-0/+1
| | | | | | | Changes: - Add the description meta tag in the index, articles and books - Add a brief description in each article and book. - Remove the SVN expansion tag
* [committers-guide] Fix quotesFernando Apesteguía2021-04-221-1/+1
| | | | | | | Follow-up for commit 5e5b9e25d72bb4001933071b41aeaedf932384e9 Reported by: 0mp Approved by: 0mp (mentor)
* [handbook] Show how to configure sleep on lid closureFernando Apesteguía2021-04-221-0/+15
| | | | | | | | Add information about how to make FreeBSD sleep and resume when the lid state switches. Approved By: 0mp (mentor) Differential Revision: https://reviews.freebsd.org/D29897
* Use sysrc instead of echo to modify rc.confMateusz Piotrowski2021-04-191-1/+1
|
* [handbook] Add reference to acpi_video(4)Fernando Apesteguía2021-04-051-0/+15
| | | | | | | | Section 12.13.1 explains how to configure ACPI. Add a small paragraph explaining how to use the acpi_video(4) driver so some laptop brightness keys can work. Approved by: gbe (mentor) Differential Revision: https://reviews.freebsd.org/D29567
* [handbook] Remove trailing whitespacesFernando Apesteguía2021-04-051-2/+2
| | | | | | | In section 12.13 as reported by igor(1) Accepted by: gbe (mentor) Differential Revision: https://reviews.freebsd.org/D29568
* Use correct syntax markup for shellLi-Wen Hsu2021-03-141-45/+45
| | | | Approved by: carlavilla
* Multiple files: Fix 'shared' referencesCeri Davies2021-02-221-2/+2
| | | | | | | | The hier(7) man-page lists /usr/share as the location for architecture-independent files, so fix a few instances where the documentation referes to /usr/shared instead of /usr/share. PR: 253760
* Migrate doc to Hugo/AsciiDoctorSergio Carlavilla Delgado2021-01-251-0/+1520
I'm very pleased to announce the release of our new website and documentation using the new toolchain with Hugo and AsciiDoctor. To get more information about the new toolchain please read the FreeBSD Documentation Project Primer[1], Hugo docs[2] and AsciiDoctor docs[3]. Acknowledgment: Benedict Reuschling <bcr@> Glen Barber <gjb@> Hiroki Sato <hrs@> Li-Wen Hsu <lwhsu@> Sean Chittenden <seanc@> The FreeBSD Foundation [1] https://docs.FreeBSD.org/en/books/fdp-primer/ [2] https://gohugo.io/documentation/ [3] https://docs.asciidoctor.org/home/ Approved by: doceng, core