From nobody Thu Jul 06 17:57:06 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4QxkkY12Hjz4lwyl for ; Thu, 6 Jul 2023 17:57:09 +0000 (UTC) (envelope-from jhb@FreeBSD.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QxkkY0WXtz3mxY; Thu, 6 Jul 2023 17:57:09 +0000 (UTC) (envelope-from jhb@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688666229; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=ZzEoWe1I37AEkfq3NiDKM2cp/0+2oIBccge6/Qe82bg=; b=Z5npDK2KHKdrjl/PflZ5Pe741NfeVd4POmIDM1M4WQPZmBlUK5iRO2bZv4D7BppmnIZIjT JdCr0knUNUnjLcUp5wbu6Lmf7yyEQv3xzqKidhtJjqZYXdoyM9ANSKscEVKZJES/4sHLKB 9xhCS4r9QyDe5ozgCqWPQK5HofQrv2FWJLof1xyJdCfyP0ZORBvZySAx8IQbuwDWplkogs hvYqbTulvesYQIKhED2+kQUls9LE8BZEvM//tK8HebxhSvgUxjp5fU73D7orZ/XQu5qs1X 1yUMNB4cNh6G22kTsIdFJJg6171OcfWgSNDzVx0ns362kBUyEz1I16oODw1OhA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688666229; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=ZzEoWe1I37AEkfq3NiDKM2cp/0+2oIBccge6/Qe82bg=; b=TQ7MEjUyywWfNgOfzflW0bsdt6IghxN7Mz7uS+KP3RCQXJS7dI3LBlWWX6qvlcYtFwOH1n W+fd+cfGxRxhjOOo726CIbNOy49zlAfk5Tsz8ku+Oy2O9NB6MZSTgFHCkMV7+0kh8/2zbI AVGFdOAyMh0M2BqapmIuPg26+UK6JlTJX/DCjNztejJ+ELGLFH2OaND/PeiRFeYCa52llp 1C4DFHVKg8qaoaK/08DuARhl2OEXUZSjB63UjQ3rqthfumf4nG5HgGOId/6/Uow+Mm8aQ/ r8tV+JIPqpHcvf+JYzRCfhfZNfmBjVEsLbizzf78eFsksPGMXrEeOBaueKwImA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688666229; a=rsa-sha256; cv=none; b=D/YjSngIMBN18QcxNxqj+SN51rkI344SnaOvdk4VA/QjBxmWwdO3Q5u1I1ipgEY2vVLy7Z 23Jf46v0tJyjhubdGiaFLOHO/LiLAp0gM1ngqJE/T/OP9WpsYcLnfH0g4L0DVh0PtJg45b e5eM6zzA+9H8Ha0O+QIkwTRJJk5DKH/6l9W4bDkRopxR9Lg55rldVYznIaSYCDQXLnTOzd 5bNJzTBeTwKq7Hrf5Gl9/EXAEJGH+wig6ZYK/5HpeT4tEkHd3cyUCbcID1vnzYJKsixHsx j6xsz2ZdFJYk6EsPV7Rr4jyJjBHC7+9ZnSpZFRzuylvUp/VfEYMg7nqcyU77EQ== Received: from [IPV6:2601:648:8680:16b0:9018:f799:cdac:ccb1] (unknown [IPv6:2601:648:8680:16b0:9018:f799:cdac:ccb1]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (Client did not present a certificate) (Authenticated sender: jhb) by smtp.freebsd.org (Postfix) with ESMTPSA id 4QxkkX45jxzLFW; Thu, 6 Jul 2023 17:57:08 +0000 (UTC) (envelope-from jhb@FreeBSD.org) Message-ID: Date: Thu, 6 Jul 2023 10:57:06 -0700 List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:102.0) Gecko/20100101 Thunderbird/102.12.0 Subject: Re: git: b113509f32 - main - Handbook WG - Create a new network chapter Content-Language: en-US To: Sergio Carlavilla Delgado , doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org References: <202307061209.366C9IeC054160@gitrepo.freebsd.org> From: John Baldwin In-Reply-To: <202307061209.366C9IeC054160@gitrepo.freebsd.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-ThisMailContainsUnwantedMimeParts: N On 7/6/23 5:09 AM, Sergio Carlavilla Delgado wrote: > The branch main has been updated by carlavilla: > > URL: https://cgit.FreeBSD.org/doc/commit/?id=b113509f32da681db41fd60594b723c13334df8e > > commit b113509f32da681db41fd60594b723c13334df8e > Author: Sergio Carlavilla Delgado > AuthorDate: 2023-07-06 12:04:54 +0000 > Commit: Sergio Carlavilla Delgado > CommitDate: 2023-07-06 12:04:54 +0000 > > Handbook WG - Create a new network chapter > > 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 > --- > .../books/handbook/advanced-networking/_index.adoc | 897 +------------------ > .../content/en/books/handbook/audit/_index.adoc | 6 +- > .../en/books/handbook/bibliography/_index.adoc | 2 +- > documentation/content/en/books/handbook/book.adoc | 2 + > .../content/en/books/handbook/boot/_index.adoc | 6 +- > .../content/en/books/handbook/colophon.adoc | 2 +- > .../content/en/books/handbook/config/_index.adoc | 492 +---------- > .../en/books/handbook/cutting-edge/_index.adoc | 8 +- > .../content/en/books/handbook/desktop/_index.adoc | 6 +- > .../content/en/books/handbook/disks/_index.adoc | 6 +- > .../content/en/books/handbook/dtrace/_index.adoc | 6 +- > .../en/books/handbook/eresources/_index.adoc | 2 +- > .../en/books/handbook/filesystems/_index.adoc | 6 +- > .../en/books/handbook/firewalls/_index.adoc | 6 +- > .../content/en/books/handbook/geom/_index.adoc | 6 +- > .../content/en/books/handbook/glossary.adoc | 4 +- > .../content/en/books/handbook/jails/_index.adoc | 6 +- > .../en/books/handbook/kernelconfig/_index.adoc | 153 ++-- > .../content/en/books/handbook/l10n/_index.adoc | 6 +- > .../content/en/books/handbook/linuxemu/_index.adoc | 42 +- > .../content/en/books/handbook/mac/_index.adoc | 6 +- > .../content/en/books/handbook/mail/_index.adoc | 6 +- > .../content/en/books/handbook/mirrors/_index.adoc | 8 +- > .../en/books/handbook/multimedia/_index.adoc | 6 +- > .../en/books/handbook/network-servers/_index.adoc | 6 +- > .../content/en/books/handbook/network/_index.adoc | 951 +++++++++++++++++++++ > .../content/en/books/handbook/partii.adoc | 4 +- > .../content/en/books/handbook/partiii.adoc | 2 +- > .../content/en/books/handbook/partiv.adoc | 2 +- > documentation/content/en/books/handbook/partv.adoc | 2 +- > .../content/en/books/handbook/pgpkeys/_index.adoc | 2 +- > .../content/en/books/handbook/ports/_index.adoc | 28 +- > .../en/books/handbook/ppp-and-slip/_index.adoc | 6 +- > .../content/en/books/handbook/printing/_index.adoc | 6 +- > .../content/en/books/handbook/security/_index.adoc | 12 +- > .../en/books/handbook/serialcomms/_index.adoc | 6 +- > .../en/books/handbook/usb-device-mode/_index.adoc | 6 +- > .../en/books/handbook/virtualization/_index.adoc | 6 +- > .../content/en/books/handbook/wayland/_index.adoc | 2 +- > .../content/en/books/handbook/wine/_index.adoc | 6 +- > .../content/en/books/handbook/zfs/_index.adoc | 11 +- > 41 files changed, 1202 insertions(+), 1546 deletions(-) > > diff --git a/documentation/content/en/books/handbook/advanced-networking/_index.adoc b/documentation/content/en/books/handbook/advanced-networking/_index.adoc > index 732de75166..b9194449cd 100644 > --- a/documentation/content/en/books/handbook/advanced-networking/_index.adoc > +++ b/documentation/content/en/books/handbook/advanced-networking/_index.adoc > @@ -1,12 +1,12 @@ > --- > -title: Chapter 33. Advanced Networking > +title: Chapter 34. Advanced Networking > part: IV. Network Communication > prev: books/handbook/firewalls > next: books/handbook/partv > description: "Advanced networking in FreeBSD: basics of gateways and routes, CARP, how to configure multiple VLANs on FreeBSD, etc" > -tags: ["Advanced Networking", "Handbook", "gateway", "routes", "wireless", "tethering", "bluetooth", "bridging", "ipv6", "CARP", "VLAN"] > +tags: ["Advanced Networking", "Handbook", "gateway", "routes", "wireless", "tethering", "bluetooth", "bridging", "CARP", "VLAN"] > showBookMenu: true > -weight: 38 > +weight: 39 > path: "/books/handbook/" > --- > > @@ -18,7 +18,7 @@ path: "/books/handbook/" > :icons: font > :sectnums: > :sectnumlevels: 6 > -:sectnumoffset: 33 > +:sectnumoffset: 34 > :partnums: > :source-highlighter: rouge > :experimental: It seems a bit unfortunate (and fragile?) that chapter and section numbers had to be manually changed in this commit for other chapters besides the added one. Is there a way to use a counter to auto-generate these similar to using tags in DocBook or \begin{chapter} in LaTeX? Also, I'm kind of curious what the "weight" attribute is and if it can similarly be auto-computed and not manually set? -- John Baldwin