From nobody Mon Nov 15 16:23:32 2021 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 A9BF51851751 for ; Mon, 15 Nov 2021 16:23:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HtDyX4Lsrz4QnM; Mon, 15 Nov 2021 16:23:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 753931D050; Mon, 15 Nov 2021 16:23:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AFGNWbP093213; Mon, 15 Nov 2021 16:23:32 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AFGNWND093212; Mon, 15 Nov 2021 16:23:32 GMT (envelope-from git) Date: Mon, 15 Nov 2021 16:23:32 GMT Message-Id: <202111151623.1AFGNWND093212@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Daniel Ebdrup Jensen Subject: git: 041d8d9742 - main - status: Add the third status report for 2021 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: debdrup X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 041d8d9742984e81138b2bbf4295f809b12b5a2b Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by debdrup: URL: https://cgit.FreeBSD.org/doc/commit/?id=041d8d9742984e81138b2bbf4295f809b12b5a2b commit 041d8d9742984e81138b2bbf4295f809b12b5a2b Author: Daniel Ebdrup Jensen AuthorDate: 2021-11-15 16:17:38 +0000 Commit: Daniel Ebdrup Jensen CommitDate: 2021-11-15 16:22:07 +0000 status: Add the third status report for 2021 As with previous reports, too many peolpe have contributed to this to list them all, and the log can still be found in the freebsd-quarterly repo of the freebsd organization on github. --- .../en/status/report-2021-07-2021-09/_index.adoc | 229 +++++++++++++++++++++ .../en/status/report-2021-07-2021-09/arm64.adoc | 53 +++++ .../en/status/report-2021-07-2021-09/azure.adoc | 35 ++++ .../report-2021-07-2021-09/boot-performance.adoc | 30 +++ .../en/status/report-2021-07-2021-09/ci.adoc | 57 +++++ .../status/report-2021-07-2021-09/clusteradm.adoc | 33 +++ .../report-2021-07-2021-09/copy_staging.adoc | 78 +++++++ .../en/status/report-2021-07-2021-09/cpe.adoc | 49 +++++ .../current-compilation-time-analysis.adoc | 99 +++++++++ .../en/status/report-2021-07-2021-09/doceng.adoc | 29 +++ .../en/status/report-2021-07-2021-09/ena.adoc | 30 +++ .../en/status/report-2021-07-2021-09/erlang.adoc | 50 +++++ .../report-2021-07-2021-09/freebsd-foundation.adoc | 183 ++++++++++++++++ .../en/status/report-2021-07-2021-09/git.adoc | 29 +++ .../en/status/report-2021-07-2021-09/gitlab.adoc | 11 + .../status/report-2021-07-2021-09/hellosystem.adoc | 25 +++ .../report-2021-07-2021-09/holepunching.adoc | 17 ++ .../en/status/report-2021-07-2021-09/intelnet.adoc | 19 ++ .../en/status/report-2021-07-2021-09/iwlwifi.adoc | 23 +++ .../en/status/report-2021-07-2021-09/kde.adoc | 36 ++++ .../status/report-2021-07-2021-09/linuxulator.adoc | 24 +++ .../en/status/report-2021-07-2021-09/lldb.adoc | 41 ++++ .../en/status/report-2021-07-2021-09/mgb.adoc | 25 +++ .../en/status/report-2021-07-2021-09/mixer.adoc | 25 +++ .../report-2021-07-2021-09/msdosfs_rename.adoc | 26 +++ .../en/status/report-2021-07-2021-09/ocf-wg.adoc | 35 ++++ .../status/report-2021-07-2021-09/opensearch.adoc | 15 ++ .../en/status/report-2021-07-2021-09/openssh.adoc | 33 +++ .../en/status/report-2021-07-2021-09/portmgr.adoc | 31 +++ .../en/status/report-2021-07-2021-09/pot.adoc | 31 +++ .../report-2021-07-2021-09/raidz-expansion.adoc | 29 +++ .../en/status/report-2021-07-2021-09/releng.adoc | 17 ++ .../en/status/report-2021-07-2021-09/rfc1191.adoc | 17 ++ .../en/status/report-2021-07-2021-09/rtw88.adoc | 19 ++ .../status/report-2021-07-2021-09/sdhci_acpi.adoc | 19 ++ .../en/status/report-2021-07-2021-09/stackgap.adoc | 25 +++ .../status/report-2021-07-2021-09/syzkaller.adoc | 29 +++ .../en/status/report-2021-07-2021-09/valgrind.adoc | 22 ++ .../en/status/report-2021-07-2021-09/vmd.adoc | 30 +++ .../en/status/report-2021-07-2021-09/wg.adoc | 19 ++ .../en/status/report-2021-07-2021-09/wine.adoc | 21 ++ .../en/status/report-2021-07-2021-09/www.adoc | 23 +++ .../en/status/report-2021-07-2021-09/ztop.adoc | 25 +++ 43 files changed, 1696 insertions(+) diff --git a/website/content/en/status/report-2021-07-2021-09/_index.adoc b/website/content/en/status/report-2021-07-2021-09/_index.adoc new file mode 100644 index 0000000000..ab2330c647 --- /dev/null +++ b/website/content/en/status/report-2021-07-2021-09/_index.adoc @@ -0,0 +1,229 @@ +--- +title: "FreeBSD Quarterly Status Report 3rd Quarter 2021" +sidenav: about +--- + += Introduction +:doctype: article +:toc: macro +:toclevels: 2 +:icons: font +:!sectnums: +:source-highlighter: rouge +:experimental: +:reports-path: content/en/status/report-2021-07-2021-09 + +This report covers FreeBSD related projects for the period between July and September, and is the third of four planned reports for 2021, and contains 42 entries. + +The third quarter of 2021 was quite active in lots of different areas, so the report covers a bunch of interesting work including but not limited to boot performance, compile-time analysis, hole-punching support, various drivers, ZFS raidz expansion, an update to the sound mixer, and many more. + +Regrettably, the status report got a bit delayed, but we hope that the aphorism better late than never can apply here. + +Yours, + +Daniel Ebdrup Jensen, with status hat on. + +''' + +toc::[] + +''' + +[[FreeBSD-Team-Reports]] +== FreeBSD Team Reports + +Entries from the various official and semi-official teams, as found in the link:../../administration/[Administration Page]. + +include::{reports-path}/freebsd-foundation.adoc[] + +''' + +include::{reports-path}/releng.adoc[] + +''' + +include::{reports-path}/clusteradm.adoc[] + +''' + +include::{reports-path}/ci.adoc[] + +''' + +include::{reports-path}/portmgr.adoc[] + +''' + +include::{reports-path}/doceng.adoc[] + +''' + +include::{reports-path}/www.adoc[] + +''' + +[[projects]] +== Projects + +Projects that span multiple categories, from the kernel and userspace to the Ports Collection or external projects. + +include::{reports-path}/boot-performance.adoc[] + +''' + +include::{reports-path}/git.adoc[] + +''' + +include::{reports-path}/lldb.adoc[] + +''' + +include::{reports-path}/linuxulator.adoc[] + +''' + +include::{reports-path}/mixer.adoc[] + +''' + +include::{reports-path}/openssh.adoc[] + +''' + +[[kernel]] +== Kernel + +Updates to kernel subsystems/features, driver support, filesystems, and more. + +include::{reports-path}/arm64.adoc[] + +''' + +include::{reports-path}/azure.adoc[] + +''' + +include::{reports-path}/copy_staging.adoc[] + +''' + +include::{reports-path}/ena.adoc[] + +''' + +include::{reports-path}/holepunching.adoc[] + +''' + +include::{reports-path}/intelnet.adoc[] + +''' + +include::{reports-path}/iwlwifi.adoc[] + +''' + +include::{reports-path}/mgb.adoc[] + +''' + +include::{reports-path}/msdosfs_rename.adoc[] + +''' + +include::{reports-path}/raidz-expansion.adoc[] + +''' + +include::{reports-path}/rfc1191.adoc[] + +''' + +include::{reports-path}/rtw88.adoc[] + +''' + +include::{reports-path}/sdhci_acpi.adoc[] + +''' + +include::{reports-path}/stackgap.adoc[] + +''' + +include::{reports-path}/syzkaller.adoc[] + +''' + +include::{reports-path}/ocf-wg.adoc[] + +''' + +include::{reports-path}/vmd.adoc[] + +''' + +[[ports]] +== Ports + +Changes affecting the Ports Collection, whether sweeping changes that touch most of the tree, or individual ports themselves. + +include::{reports-path}/cpe.adoc[] + +''' + +include::{reports-path}/erlang.adoc[] + +''' + +include::{reports-path}/kde.adoc[] + +''' + +include::{reports-path}/opensearch.adoc[] + +''' + +include::{reports-path}/valgrind.adoc[] + +''' + +include::{reports-path}/wine.adoc[] + +''' + +include::{reports-path}/ztop.adoc[] + +''' + +[[miscellaneous]] +== Miscellaneous + +Objects that defy categorization. + +include::{reports-path}/current-compilation-time-analysis.adoc[] + +''' + +[[third-Party-Projects]] +== Third-Party Projects + +Many projects build upon FreeBSD or incorporate components of FreeBSD into their project. +As these projects may be of interest to the broader FreeBSD community, we sometimes include brief updates submitted by these projects in our quarterly report. +The FreeBSD project makes no representation as to the accuracy or veracity of any claims in these submissions. + +include::{reports-path}/gitlab.adoc[] + +''' + +include::{reports-path}/hellosystem.adoc[] + +''' + +include::{reports-path}/pot.adoc[] + +''' + +include::{reports-path}/wg.adoc[] + +''' diff --git a/website/content/en/status/report-2021-07-2021-09/arm64.adoc b/website/content/en/status/report-2021-07-2021-09/arm64.adoc new file mode 100644 index 0000000000..3d3542dae6 --- /dev/null +++ b/website/content/en/status/report-2021-07-2021-09/arm64.adoc @@ -0,0 +1,53 @@ +=== Arm64 improvements + +Links: + +link:https://reviews.freebsd.org/D31261[Pointer Authentication Review] URL: link:https://reviews.freebsd.org/D31261[https://reviews.freebsd.org/D31261] + +Contact: Andrew Turner + +FreeBSD has been ported to the Arm Armv8-A Architecture Envelope Model (AEM), an +Armv8 architecture simulator. AEM is useful for Armv8 development and testing, +because it supports different configurations, including the ability to enable or +disable different extensions. As part of this work, the virtio legacy pci +driver was fixed and ACPI resource parsing code was updated to work with the +ACPI tables that the model provides. + +Libmd(4) has been updated to use the sha256 instructions when available. This +can lead to a large performance improvement when these instructions are +available. For example, on the Apple M1 under a hypervisor, the time to +calculate the sha256 of a 1GB file has decreased from a median of 3.46s to 0.5s. + +Using an ifunc (indirect function) in a static binary is now supported. This will allow +different implementations of a function to be used depending on which hardware +it is being run on. Using an ifunc in dynamic binaries was already +supported. + +The arm64 ID register definitions have been updated to match the Armv8.5 +specification and other special registers have been updated to the Armv8.7 spec. + +There have been numerous cleanups in decoding the arm64 ID registers in the +kernel to ensure we provide a consistent view of the hardware to userspace if it +reads the emulated ID register directly, or uses an ELF HWCAP value. + +There has been early work on supporting the Arm Reliability, Availability, and +Serviceability (RAS) extension. The external aborts it may use are now handled +in the kernel. + +Support for the Arm Pointer Authentication extension is under review. This +extension allows programs to use new instructions that add a hash to unused bits +in a code or data pointer. They can then later check the hash in a way that will +either, depending on the CPU, create an invalid pointer or raise an exception. +This can be used to protect the function return address from being overwritten, +making Return Oriented Programming (ROP) attacks difficult. The change supports +both userspace and kernel pointer authentication. It is waiting on debugger +changes to be sent upstream so lldb can clear the hash when needed, e.g., in a +stack trace. + +Work has started on supporting the Branch Target Identification extension. This +adds a flag to the page tables to disallow unintended targets from some branch +instructions. When a CPU branches to a new location from a register, the CPU +will check if the instruction is correct. This will protect, e.g., against a +function pointer being called when it points to the middle of a function. The +kernel has been built with this feature enabled and tested in the Arm AEM. + +Sponsor: The FreeBSD Foundation diff --git a/website/content/en/status/report-2021-07-2021-09/azure.adoc b/website/content/en/status/report-2021-07-2021-09/azure.adoc new file mode 100644 index 0000000000..e381ce3c21 --- /dev/null +++ b/website/content/en/status/report-2021-07-2021-09/azure.adoc @@ -0,0 +1,35 @@ +=== FreeBSD on Microsoft HyperV and Azure + +Links: + +link:https://wiki.freebsd.org/MicrosoftAzure[Microsoft Azure article on FreeBSD wiki] URL: link:https://wiki.freebsd.org/MicrosoftAzure[] + +link:https://wiki.freebsd.org/HyperV[Microsoft HyperV article on FreeBSD wiki] URL: link:https://wiki.freebsd.org/HyperV[] + +Contact: Microsoft FreeBSD Integration Services Team + +Contact: link:https://lists.FreeBSD.org/mailman/listinfo/freebsd-cloud[freebsd-cloud Mailing List] + +Contact: The FreeBSD Azure Release Engineering Team + +Contact: Wei Hu + +Contact: Li-Wen Hsu + + +The link:https://azuremarketplace.microsoft.com/marketplace/apps/thefreebsdfoundation.freebsd-13_0[13.0-RELEASE image on Azure Marketplace] has been link:https://lists.freebsd.org/pipermail/freebsd-announce/2021-September/002059.html[published]. + +The changes for building official images on Azure Marketplace, which fulfill the requirements of Azure and FreeBSD cloud images like disk layout and UEFI for Gen2 VM, along with some minor improvements like configurations to speed up booting, have been link:https://cgit.freebsd.org/src/commit/?id=fbece7609573bd51080e949df03fa3d803a637ae[imported]. + +Above tasks are sponsored by The FreeBSD Foundation, with resources provided by Microsoft. + +Microsoft Azure Network Adapter (MANA) is the new network adapter from Microsoft which will be available in the Azure public cloud. +It provides SR-IOV NIC as a Virtual Function (VF) to guest OS running on Hyper-V. +Wei link:https://reviews.freebsd.org/D31150[has been working] on its driver for a while and link:https://cgit.freebsd.org/src/commit/?id=ce110ea12fcea71ae437d0a1d0549d3d32055b0e[committed] in this quarter. + +This task is sponsored by Microsoft. + +Work in progress tasks: + +* Build and publish gen2 vm image to Azure Marketplace +* Build and publish ZFS-based image to Azure Marketplace +* Upstream link:https://github.com/Azure/WALinuxAgent/pull/1892[local modifications of Azure agent] +* Update link:https://www.freshports.org/sysutils/azure-agent[Azure agent port] to the latest version + +Open tasks: + +* Update FreeBSD related doc at link:https://docs.microsoft.com[] +* Support FreeBSD in link:https://azure.microsoft.com/services/devops/pipelines/[Azure Pipelines] diff --git a/website/content/en/status/report-2021-07-2021-09/boot-performance.adoc b/website/content/en/status/report-2021-07-2021-09/boot-performance.adoc new file mode 100644 index 0000000000..84f232382f --- /dev/null +++ b/website/content/en/status/report-2021-07-2021-09/boot-performance.adoc @@ -0,0 +1,30 @@ +=== Boot Performance Improvements + +Links: + +link:https://wiki.freebsd.org/BootTime[Wiki page] URL: link:https://wiki.freebsd.org/BootTime[https://wiki.freebsd.org/BootTime] + +link:https://www.daemonology.net/blog/2021-08-12-EC2-boot-time-benchmarking.html[OS boot time comparison] URL: link:https://www.daemonology.net/blog/2021-08-12-EC2-boot-time-benchmarking.html[https://www.daemonology.net/blog/2021-08-12-EC2-boot-time-benchmarking.html] + +Contact: Colin Percival + +Colin Percival is coordinating an effort to speed up the FreeBSD boot process. +For benchmarking purposes, he is using an EC2 c5.xlarge instance as a reference +platform and is measuring the time between when the virtual machine enters the +EC2 "running" state and when it is possible to SSH into the instance. + +This work started in 2017, leading to a conference presentation, "Profiling +the FreeBSD kernel boot", and quickly yielded roughly 4850 ms of improvements +(starting from a baseline of about 30 seconds). + +Since June, another roughly 9790 ms of time has been shaved off the boot +process, taking it down to approximately 15 seconds. There is still more work +to be done; in particular, while the loader and kernel have been profiled, the +TSLOG system Colin is using does not currently support userland profiling. + +Issues are listed on the wiki page as they are identified; the wiki page also +has instructions for performing profiling. Users are encouraged to profile +the boot process on their own systems, in case they experience delays which +don't show up on the system Colin is using for testing. + +This work is supported by Colin's FreeBSD/EC2 Patreon. + +Sponsor: https://www.patreon.com/cperciva diff --git a/website/content/en/status/report-2021-07-2021-09/ci.adoc b/website/content/en/status/report-2021-07-2021-09/ci.adoc new file mode 100644 index 0000000000..6101148ede --- /dev/null +++ b/website/content/en/status/report-2021-07-2021-09/ci.adoc @@ -0,0 +1,57 @@ +=== Continuous Integration + +Links: + +link:https://ci.FreeBSD.org[FreeBSD Jenkins Instance] URL: link:https://ci.FreeBSD.org[https://ci.FreeBSD.org] + +link:https://artifact.ci.FreeBSD.org[FreeBSD CI artifact archive] URL: link:https://artifact.ci.FreeBSD.org[https://artifact.ci.FreeBSD.org] + +link:https://wiki.freebsd.org/Jenkins[FreeBSD Jenkins wiki] URL: link:https://wiki.freebsd.org/Jenkins[https://wiki.freebsd.org/Jenkins] + +link:https://wiki.freebsd.org/HostedCI[Hosted CI wiki] URL: link:https://wiki.freebsd.org/HostedCI[https://wiki.freebsd.org/HostedCI] + +link:https://wiki.freebsd.org/3rdPartySoftwareCI[3rd Party Software CI] URL: link:https://wiki.freebsd.org/3rdPartySoftwareCI[https://wiki.freebsd.org/3rdPartySoftwareCI] + +link:https://preview.tinyurl.com/y9maauwg[Tickets related to freebsd-testing@] URL: link:https://preview.tinyurl.com/y9maauwg[https://preview.tinyurl.com/y9maauwg] + +link:https://github.com/freebsd/freebsd-ci[FreeBSD CI Repository] URL: link:https://github.com/freebsd/freebsd-ci[https://github.com/freebsd/freebsd-ci]+ +link:https://lists.freebsd.org/subscription/dev-ci[dev-ci Mailing List] URL: link:https://lists.freebsd.org/subscription/dev-ci[https://lists.freebsd.org/subscription/dev-ci] + +Contact: Jenkins Admin + +Contact: Li-Wen Hsu + +Contact: link:https://lists.FreeBSD.org/mailman/listinfo/freebsd-testing[freebsd-testing Mailing List] + +Contact: IRC #freebsd-ci channel on EFNet + +The FreeBSD CI team maintains the continuous integration system of the FreeBSD project. +The CI system checks the committed changes can be successfully built, then performs various tests and analysis over the newly built results. +The artifacts from those builds are archived in the link:https://artifact.ci.FreeBSD.org[artifact server] for further testing and debugging needs. +The CI team members examine the failing builds and unstable tests and work with the experts in that area to fix the code or adjust test infrastructure. + +During the third quarter of 2021, we continued working with the contributors and developers in the project to fulfil their testing needs and also keep collaborating with external projects and companies to improve their products and FreeBSD. + +Important changes: + +* The results of link:https://ci.freebsd.org/job/FreeBSD-main-amd64-build[FreeBSD-main-amd64-build] and link:https://ci.freebsd.org/job/FreeBSD-main-amd64-test[FreeBSD-main-amd64-test] jobs are sent to the link:https://lists.freebsd.org/subscription/dev-ci[dev-ci mailing list] + +New jobs: + +* link:https://ci.freebsd.org/job/FreeBSD-main-amd64-KASAN_test[Run tests with KASAN enabled for main on amd64] +* link:https://ci.freebsd.org/job/FreeBSD-main-amd64-KMSAN_test[Run tests with KMSAN enabled for main on amd64] + +Retired jobs: + +* The jobs for stable/11 branch were removed after September 30th per link:https://lists.freebsd.org/pipermail/freebsd-announce/2021-September/002060.html[FreeBSD 11.4 end-of-life] + +Work in progress and open tasks: + +* Designing and implementing pre-commit CI building and testing (to support the link:https://gitlab.com/bsdimp/freebsd-workflow[workflow working group]) +* Designing and implementing use of CI cluster to build release artifacts as release engineering does +* Collecting and sorting CI tasks and ideas link:https://hackmd.io/@FreeBSD-CI/freebsd-ci-todo[here] +* Testing and merging pull requests in link:https://github.com/freebsd/freebsd-ci/pulls[the FreeBSD-ci repo] +* Reducing the procedures of CI/test environment setting up for contributors and developers +* Setting up the CI stage environment and putting the experimental jobs on it +* Setting up public network access for the VM guest running tests +* Implementing using bare metal hardware to run test suites +* Adding drm ports building tests against -CURRENT +* Planning to run ztest tests +* Adding more external toolchain related jobs +* Improving maturity of the hardware lab and adding more hardware under test +* Helping more software get FreeBSD support in its CI pipeline (Wiki pages: link:https://wiki.freebsd.org/3rdPartySoftwareCI[3rdPartySoftwareCI], link:https://wiki.freebsd.org/HostedCI[HostedCI]) +* Working with hosted CI providers to have better FreeBSD support + +Please see link:https://bugs.freebsd.org/bugzilla/buglist.cgi?bug_status=__open__&email1=testing%40FreeBSD.org&emailassigned_to1=1&emailcc1=1&emailreporter1=1&emailtype1=substring&query_format=advanced[freebsd-testing@ related tickets] for more WIP information, and don't hesitate to join the effort! + +Sponsor: The FreeBSD Foundation diff --git a/website/content/en/status/report-2021-07-2021-09/clusteradm.adoc b/website/content/en/status/report-2021-07-2021-09/clusteradm.adoc new file mode 100644 index 0000000000..02fcf29dc6 --- /dev/null +++ b/website/content/en/status/report-2021-07-2021-09/clusteradm.adoc @@ -0,0 +1,33 @@ +=== Cluster Administration Team + +Links: + +link:https://www.freebsd.org/administration/#t-clusteradm[Cluster Administration Team members] URL: link:https://www.freebsd.org/administration/#t-clusteradm[https://www.freebsd.org/administration/#t-clusteradm] + +Contact: Cluster Administration Team + +FreeBSD Cluster Administration Team members are responsible for managing the machines the Project relies on to synchronise its distributed work and communications. +In this quarter, the team has worked on the following: + +- Fixed www.FreeBSD.org mirror sync source +- Improvements to GeoDNS for {download,ftp,pkg}.FreeBSD.org + - Added IPv6 support + - More optimal mirror selection in Asia +- Finished installing a new mirror site in Japan, sponsored by Broadband Tower, Inc. + - Full mirror site (ftp, pkg, git, doc, dns,...) + - The network and machine resources for this mirror are generously sponsored by the Cloud and SDN Laboratory at BroadBand Tower, Inc., one of the Internet data center service providers in Tokyo, Japan, with 300+ Gbps international IP transit bandwidth +- Improved the retention script used for the artifact server of CI cluster to offer a mix of the latest artifacts but also a selection of older artifacts for comparison, space permitting +- Ongoing day to day cluster administration + - Replacing failed disks + - Babysitting pkgsync + +Work in progress: + +- Move pkg-master.nyi to new hardware +- Improve the package building infrastructure +- Review the service jails and service administrators operation +- Setup powerpc pkgbuilder/ref/universal machines +- Search for more providers that can fit the requirements for a link:https://wiki.freebsd.org/Teams/clusteradm/generic-mirror-layout[generic mirrored layout] or a link:https://wiki.freebsd.org/Teams/clusteradm/tiny-mirror[tiny mirror] +- Upgrading public-facing cluster services from 12.2-STABLE to 13.0-STABLE +- Working with doceng@ to improve https://www.freebsd.org and https://docs.freebsd.org +- Improve the web service architecture +- Improve the cluster backup plan diff --git a/website/content/en/status/report-2021-07-2021-09/copy_staging.adoc b/website/content/en/status/report-2021-07-2021-09/copy_staging.adoc new file mode 100644 index 0000000000..134f73b7df --- /dev/null +++ b/website/content/en/status/report-2021-07-2021-09/copy_staging.adoc @@ -0,0 +1,78 @@ +=== Improved amd64 UEFI boot + +Contact: Konstantin Belousov + +UEFI BIOS on PC provides a much richer and more streamlined environment +for pre-OS programs, but also imposes some requirements on the +programs that are executed there, OS loaders in particular. One +such requirement is that the loader must coordinate its memory use with +the BIOS, only using memory that was allocated for it. Even after the loader +handoff to the operating system kernel, there are still some memory +regions that are reserved by the BIOS for different reasons. Examples +are runtime services code and data. + +On the other hand, legacy/CSM BIOS boot works with memory completely +differently; there are known memory regions that hold BIOS data and +must be avoided. Otherwise, the memory is considered free for loader +and OS to use. (Of course it is not that straightforward, the +definition of known regions is up to the vendor and there are a lot of +workarounds there.) + +The BIOS boot puts the kernel and preloaded data (like modules, memory +disk, CPU microcode update etc) at the contigous physical memory block +starting at 2M. This algorithm goes back to how the i386 kernel boots. + +Also, when preparing to pass control to the kernel, the loader +creates very special temporary mappings, where the low 1G of physical +address space is mapped 1:1 into virtual address space, and then +repeated for each 1G until the virtual memory end. The kernel knows about +its physical location and the temporary mapping, and constructs kernel +page tables assuming that the physical address of the text is at 2M. + +This mechanism of loader to kernel handoff was left unchanged when +the loader gained support for the UEFI environment. The loader prepares kernel and +auxiliary preload data in a so-called staging area while UEFI boot +services are active, and after EFI_BOOT_SERVICES.ExitBootServices(), +the temporary mapping is activated and the staging area is copied at 2M. + +An advantage at that time was that no changes to the kernel were +needed. But there are issues; the biggest is that memory at 2M might +be not free for reuse. For instance, BIOS runtime code or data might +be located there. Or there might be no memory at 2M at all. Or +trampoline page table or code, or even some parts of the staging area +overlapping with the 2M region where staging area is copied. The +outcome was a hard to diagnose boot time failure, typically a hard hang +when the loader started the kernel. + +Another limitation is the 1G transient mapping, which due to copying +means that the total size of preloaded data cannot exceed around 400M for +everything, including kernel, memory disks, and anything else. Also +the code to grow the staging area on demand was quite unflexible, only +able to grow the staging area in place. + +The work described in this report allows the UEFI loader on amd64 to start +the kernel from the staging area without copying. Kernel assumptions +about the hand-off were explicitly identified and documented. The kernel +only requires the staging area to be located below 4G together with +the trampoline page table (this is a consequence of CPU architecture +requiring 32bit protected mode to enter long mode), be 2M aligned and +the whole low 4G mapped 1:1 at hand-off. The kernel computes its physical +address and builds kernel page tables accordingly. + +Making the kernel boot with staging area in-place required identifying +all places where the amd64 kernel had a dependency on its physical +location. The most complicated part was application processors startup, +which required rewriting initialization code, which we were able to +streamline as result. In particular, when an AP enters paging mode, it +does so straight into the correct kernel page table, without loading +intermediate trampoline page table. + +The updated loader automatically detects if the loaded kernel can handle +in-place staging area ('non-copying mode'). If needed, this can be +overridden with the loader's copy_staging command. For instance, +'copy_staging enable' tells the loader to unconditionally copy the staging +area to 2M regardless of kernel capabilities (default is 'copy_staging auto'). +Also, the code to grow the staging area was made much more robust, +allowing it to grow without hand-tuning and recompiling the loader. + +Sponsor: The FreeBSD Foundation diff --git a/website/content/en/status/report-2021-07-2021-09/cpe.adoc b/website/content/en/status/report-2021-07-2021-09/cpe.adoc new file mode 100644 index 0000000000..69a43c419f --- /dev/null +++ b/website/content/en/status/report-2021-07-2021-09/cpe.adoc @@ -0,0 +1,49 @@ +=== Improve CPE Data in the Ports Collection + +Links: + +link:https://github.com/decke/chkcpe[chkcpe] URL: link:https://github.com/decke/chkcpe[https://github.com/decke/chkcpe] + +link:https://wiki.freebsd.org/Ports/CPE[CPE on wiki.freebsd.org] URL: link:https://wiki.freebsd.org/Ports/CPE[https://wiki.freebsd.org/Ports/CPE] + +link:https://nvd.nist.gov/products/cpe[CPE Dictionary] URL: link:https://nvd.nist.gov/products/cpe[https://nvd.nist.gov/products/cpe] + + +Contact: Bernhard Froehlich + +Common Platform Enumeration (CPE) is an open standard for naming +hardware and software components. Originally developed by MITRE, +it is now maintained by NIST under the aegis of the National +Vulnerability Database. +A CPE URI uniquely identifies a device or program by its vendor, +product name, version, revision, etc. NIST maintains the official +CPE dictionary which lists CPE names for all software versions +that have ever been mentioned in an advisory. + +In the FreeBSD Ports Collection it has been possible to annotate CPE data with +`USES=cpe` since 2014 but only around 1000 ports out of 30.000 did +use it. This is why a script called `chkcpe` was created to +validate existing CPE data and find new possible matches +automatically. + +=== Why do we need it? + +It allows comparing CPE URIs for installed packages against +published vulnerability data and will give us a much better and +more complete `pkg audit`. As a side effect we will also have a +better overview of vulnerable ports in the FreeBSD Ports Collection +that need to be patched or updated. + +=== How can I help? + +In this phase there is no easy possibility for port maintainers to +help. Creating separate PRs only to add CPE data does not make +sense because the overhead is very high. This is why I did spend +some time on chkcpe to improve the review and commit workflow. +Right now review and commit consumes around 3 minutes per port. + +If you are a Ports Committer and want to help please get in touch! + +=== Open Tasks + +* Review remaining reports (~1800) and update ports when appropriate +* Improve matching quality to find more possible matches +* Support using CPE data in `pkg audit` +* Scan for vulnerable ports in the Ports Collection + diff --git a/website/content/en/status/report-2021-07-2021-09/current-compilation-time-analysis.adoc b/website/content/en/status/report-2021-07-2021-09/current-compilation-time-analysis.adoc new file mode 100644 index 0000000000..fc8a4a8e3f --- /dev/null +++ b/website/content/en/status/report-2021-07-2021-09/current-compilation-time-analysis.adoc @@ -0,0 +1,99 @@ +=== -CURRENT compilation time analysis + +Links: + +link:https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=257141[Bug 257141] URL: link:https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=257141[https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=257141] + +link:https://lists.freebsd.org/archives/freebsd-current/2021-September/index.html#msg511[Discussion on freebsd-current] URL: link:https://lists.freebsd.org/archives/freebsd-current/2021-September/index.html#msg511[https://lists.freebsd.org/archives/freebsd-current/2021-September/index.html#msg511] + +link:https://people.freebsd.org/~wosch/build-time/buildworld/[Visual chart of buildworld by stages] URL: link:https://people.freebsd.org/~wosch/build-time/buildworld/[https://people.freebsd.org/~wosch/build-time/buildworld/] + +Contact: Wolfram Schneider + +Re-building FreeBSD from source takes a lot of CPU resources. +Depending on your machine it takes between 20min and several hours. +At the end of `make buildworld' we log the real time and which +parameters are used for parallel build. E.g. + +-------------------------------------------------------------- +time make -j $(sysctl -n hw.ncpu) buildworld > buildworld.log 2>&1 +tail buildworld.log +>>> World build completed on Sat Sep 4 20:58:00 UTC 2021 +>>> World built in 7235 seconds, ncpu: 3, make -j3 + 7235.61 real 20527.30 user 915.88 sys +-------------------------------------------------------------- + + +The build process runs in several steps. +It would be great to know which step takes most of the time, +and what are the effects of special build parameters. +With a small patch in Aug 2021 we get this information now: + + +-------------------------------------------------------------- +egrep '>>> stage| real ' buildworld.log +>>> stage 1.1: legacy release compatibility shims + 0.28 real 0.18 user 0.10 sys +>>> stage 1.2: bootstrap tools + 165.99 real 472.58 user 11.56 sys +>>> stage 2.1: cleaning up the object tree + 21.47 real 36.96 user 14.14 sys + 15.87 real 29.14 user 11.87 sys +>>> stage 2.3: build tools + 2.42 real 3.79 user 0.62 sys +>>> stage 3: cross tools + 9.92 real 18.49 user 1.75 sys +>>> stage 3.1: recording build metadata + 0.07 real 0.01 user 0.06 sys +>>> stage 4.1: building includes + 16.62 real 36.46 user 9.48 sys +>>> stage 4.2: building libraries + 5440.89 real 15724.60 user 482.58 sys +>>> stage 4.3: building lib32 shim libraries + 615.91 real 1654.77 user 164.58 sys +>>> stage 4.4: building everything + 937.23 real 2540.06 user 205.47 sys +-------------------------------------------------------------- + +In this example, we spent most of the time in "stage 4.2: building libraries", +77% of the CPU time and 75% of the real time. +Now running the buildworld with the parameter WITHOUT_TOOLCHAIN=yes +we get a 3.3x faster build. Instead of 2h it will be done in 36 minutes! + +-------------------------------------------------------------- +time make -j $(sysctl -n hw.ncpu) WITHOUT_TOOLCHAIN=yes buildworld > buildworld.log 2>&1 +>>> World build completed on Fri Sep 17 12:31:41 UTC 2021 +>>> World built in 2207 seconds, ncpu: 3, make -j3 + 2207.44 real 5710.83 user 676.16 sys +-------------------------------------------------------------- + +-------------------------------------------------------------- +egrep '>>> stage| real ' buildworld.log +>>> stage 1.1: legacy release compatibility shims + 0.35 real 0.20 user 0.16 sys +>>> stage 1.2: bootstrap tools + 20.47 real 51.98 user 5.12 sys +>>> stage 2.1: cleaning up the object tree + 20.92 real 34.45 user 13.57 sys + 16.33 real 28.59 user 12.33 sys +>>> stage 2.3: build tools + 2.59 real 3.90 user 0.86 sys +>>> stage 3: cross tools + 10.46 real 18.62 user 2.35 sys +>>> stage 3.1: recording build metadata + 0.07 real 0.03 user 0.05 sys + 0.08 real 0.03 user 0.05 sys +>>> stage 4.1: building includes + 15.50 real 33.03 user 9.29 sys +>>> stage 4.2: building libraries + 750.31 real 1962.43 user 218.60 sys +>>> stage 4.3: building lib32 shim libraries + 684.05 real 1780.35 user 213.22 sys +>>> stage 4.4: building everything + 677.87 real 1787.13 user 186.82 sys +-------------------------------------------------------------- + +Using WITHOUT_TOOLCHAIN=yes is fine as long as there +are no major LLVM compiler changes. + +If you dislike this feature or suspect it is causing +trouble you can disable it with the variable TIME_ENV="" + +Next task: get more detailed timing information for the long-running stages (4.2, 4.3, 4.4) diff --git a/website/content/en/status/report-2021-07-2021-09/doceng.adoc b/website/content/en/status/report-2021-07-2021-09/doceng.adoc new file mode 100644 index 0000000000..5d7bf707ad --- /dev/null +++ b/website/content/en/status/report-2021-07-2021-09/doceng.adoc @@ -0,0 +1,29 @@ +//// +Quarter: 3rd quarter of 2021 +Prepared by: dbaio +Reviewed by: gjb, carlavilla +Last edit: $Date: 2021-10-03 05:34:14 -0300 (Sun, 03 Oct 2021) $ +Version: $Id: doceng-2021-3rd-quarter-status-report.adoc 185 2021-10-03 08:34:14Z carlavilla $ +//// + +=== Documentation Engineering Team + +Links: + +link:https://www.freebsd.org/docproj/[FreeBSD Documentation Project] URL: link:https://www.freebsd.org/docproj/[https://www.freebsd.org/docproj/] + +link:https://docs.freebsd.org/en/books/fdp-primer/[FreeBSD Documentation Project Primer for New Contributors] URL: https://docs.freebsd.org/en/books/fdp-primer/[link:https://docs.freebsd.org/en/books/fdp-primer/] + +link:https://www.freebsd.org/administration/#t-doceng[Documentation Engineering Team] URL: link:https://www.freebsd.org/administration/#t-doceng[https://www.freebsd.org/administration/#t-doceng] + +Contact: FreeBSD Doceng Team + +The doceng@ team is a body to handle some of the meta-project issues associated with the FreeBSD Documentation Project; for more information, see link:https://www.freebsd.org/internal/doceng/[FreeBSD Doceng Team Charter]. + +During the last quarter, Philip Paeps (philip@) and Li-Wen Hsu (lwhsu@), already src and ports committers, were granted documentation commit bits, both now have all commit bit types. +Ed Maste (emaste@) who is already a src committer was granted a documentation commit bit. +We also said goodbye to Murray Stokely (murray@), Gábor Kövesdán (gabor@), Warren Block (wblock@), and Sevan Janiyan (sevan@). +Gábor Kövesdán (gabor@) and Warren Block (wblock@) are now former members of the doceng@ team; we thank them for their years of service. + +Implicit (blanket) approvals were documented in the link:https://docs.freebsd.org/en/articles/committers-guide/#doc-blanket-approval[Committers Guide]. +That does not cover all cases, but doceng@ encourages any FreeBSD committer from ports and src to contribute to the doc tree. + +All ports/packages misc/freebsd-doc-* were updated. +They have the entire documentation set from the FreeBSD Documentation Project, like Handbook, FAQ, articles, and more. diff --git a/website/content/en/status/report-2021-07-2021-09/ena.adoc b/website/content/en/status/report-2021-07-2021-09/ena.adoc new file mode 100644 index 0000000000..3c62166936 --- /dev/null +++ b/website/content/en/status/report-2021-07-2021-09/ena.adoc @@ -0,0 +1,30 @@ +=== ENA FreeBSD Driver Update + +Links: + +link:https://github.com/amzn/amzn-drivers/blob/master/kernel/fbsd/ena/README[ENA README] URL: link:https://github.com/amzn/amzn-drivers/blob/master/kernel/fbsd/ena/README[https://github.com/amzn/amzn-drivers/blob/master/kernel/fbsd/ena/README] + +Contact: Michal Krawczyk + +Contact: Artur Rojek + +Contact: Marcin Wojtas + +ENA (Elastic Network Adapter) is the smart NIC available in the virtualized environment of Amazon Web Services (AWS). +The ENA driver supports multiple transmit and receive queues and can handle up to 100 Gb/s of network traffic, depending on the instance type on which it is used. + +Completed since the last update: + +* Update ENA driver to v2.4.1 +* Introduce full kernel RSS API support +* Allow reconfiguration of the RSS indirection table and hash key +* Support netmap on the c6gn/m6i AWS instance types +* Fix race between detach function and some of the procedural sysctl nodes +* Add new statistics counters +* Improve safety of the reset handling routine +* Avoid mbuf collapse on Tx path for the LLQ condition + +Work in progress: + +* Prototype the driver port to the iflib framework +* MFC the ENA v2.4.1 driver to the FreeBSD 11/12/13-STABLE branches +* Add IPv6 L4 checksum offload support to the driver + +Sponsor: Amazon.com Inc diff --git a/website/content/en/status/report-2021-07-2021-09/erlang.adoc b/website/content/en/status/report-2021-07-2021-09/erlang.adoc new file mode 100644 index 0000000000..c6e2ef415c --- /dev/null +++ b/website/content/en/status/report-2021-07-2021-09/erlang.adoc @@ -0,0 +1,50 @@ +=== FreeBSD Erlang Ecosystem Ports update + +Links: + +link:https://wiki.freebsd.org/Erlang[FreeBSD Erlang wiki] URL: link:https://wiki.freebsd.org/Erlang[https://wiki.freebsd.org/Erlang] + +link:https://erlang.org/[Erlang/OTP language] URL: link:https://erlang.org/[https://erlang.org/] + +link:https://elixir-lang.org/[Elixir language] URL: link:https://elixir-lang.org/[https://elixir-lang.org/] + +link:https://gleam.run/[Gleam language] URL: link:https://gleam.run/[https://gleam.run/] + + +Contact: FreeBSD Erlang mailing list + +The Erlang runtime system, commonly known as the BEAM, provides a +runtime that is used by a number of programming languages and +applications in the FreeBSD ports collection. + +Earlier this year, both Elixir and Erlang runtimes were brought up to +date, but as separate ports, to enable porters and users to test +applications side by side. + +In Q3, the current runtimes have been brought across as defaults - this +means that `lang/elixir` and `lang/erlang` are running as the latest +releases of these superb programming languages and runtimes. + +Older releases of `lang/erlang-runtime{21,22,23}` are still available as +ports. The very old releases prior to OTP20 have been removed from the +ports tree, as they are no longer supported upstream either. + +Only newer OTP releases include the updated SSL application that will +correctly validate cross-signed certificates, as used in Let's Encrypt's +upcoming root certificate deprecations. + +Further details on these changes are well documented at +link:https://blog.voltone.net/post/29[Erlang/OTP impact of DST Root CA X3 expiration] +and link:https://blog.voltone.net/post/30[DST Root CA X3 expiration update] + +All of the NIF driver related ports that pull in other FreeBSD ports +tree dependencies have been updated to match the newer `lang/erlang` +release, and a number of ports that are not being updated in their +upstream community, have therefore been marked as broken. + +The Erlang team is planning to: + +* remove the deprecated OTP20 and OTP21 runtimes in 2021Q4 +* remove ports directly dependent on erlang- and elixir- languages, + where they are more commonly installed via `mix` and `rebar3` tools, + the standard community build tool chain. + +Additional testing and community contributions are welcome; please +reach out on the mailing list, especially if you are able to help +testing of specific port updates. + diff --git a/website/content/en/status/report-2021-07-2021-09/freebsd-foundation.adoc b/website/content/en/status/report-2021-07-2021-09/freebsd-foundation.adoc new file mode 100644 index 0000000000..3b09a58b27 --- /dev/null +++ b/website/content/en/status/report-2021-07-2021-09/freebsd-foundation.adoc @@ -0,0 +1,183 @@ +=== FreeBSD Foundation + +Links: + +link:https://www.FreeBSDfoundation.org[FreeBSD Foundation] URL: link:https://www.FreeBSDfoundation.org[https://www.FreeBSDfoundation.org] + +link:https://freebsdfoundation.org/blog/technology-roadmap/[Technology Roadmap] URL: link:https://freebsdfoundation.org/blog/technology-roadmap/[https://freebsdfoundation.org/blog/technology-roadmap/] + +link:https://www.FreeBSDfoundation.org/donate/[Donate] URL: link:https://www.FreeBSDfoundation.org/donate/[https://www.FreeBSDfoundation.org/donate/] + +link:https://www.FreeBSDfoundation.org/FreeBSD-foundation-partnership-program/[Foundation Partnership Program] URL: link:https://www.FreeBSDfoundation.org/FreeBSD-foundation-partnership-program[https://www.FreeBSDfoundation.org/FreeBSD-foundation-partnership-program] + +link:https://www.FreeBSDfoundation.org/journal/[FreeBSD Journal] URL: link:https://www.FreeBSDfoundation.org/journal/[https://www.FreeBSDfoundation.org/journal/] + +link:https://www.FreeBSDfoundation.org/news-and-events/[Foundation News and Events] URL: link:https://www.FreeBSDfoundation.org/news-and-events/[https://www.FreeBSDfoundation.org/news-and-events/] + + +Contact: Deb Goodkin + +The FreeBSD Foundation is a 501(c)(3) non-profit organization dedicated to +supporting and promoting the FreeBSD Project and community worldwide. Donations +from individuals and corporations are used to fund and manage software +development projects, conferences, and developer summits. We also provide travel +grants to FreeBSD contributors, purchase and support hardware to improve and +maintain FreeBSD infrastructure, and provide resources to improve security, +quality assurance, and release engineering efforts. We publish marketing +material to promote, educate, and advocate for the FreeBSD Project, facilitate +collaboration between commercial vendors and FreeBSD developers, and finally, +represent the FreeBSD Project in executing contracts, license agreements, and +other legal arrangements that require a recognized legal entity. + +Here are some highlights of what we did to help FreeBSD last quarter: + +==== Fundraising Efforts + +Fundraising last quarter wasn’t as spectacular as we were hoping. But, then +again, people tend to take vacations during the summer months, which makes it +that more difficult for our funding requests to go through the management chain +for approvals. + +So far this year we’ve raised $180,000 towards our $2,000,000 spending +budget. Why do we need so much money? Well, last year we decided to make more +significant software contributions to FreeBSD. In order to do that, we had to +grow our team. We developed +link:https://freebsdfoundation.org/blog/technology-roadmap/[a technology +roadmap] based on input we were receiving from commercial users as well as +market trends. Based on the roadmap, we identified positions we needed to fill. + +This year we've hired three full-time software developers, one full-time ARM +kernel developer, and one project manager. We also are funding wifi work +full-time and some other projects to help with FreeBSD on the desktop. You can +read about this effort to attract new users and contributors to the Project in +individual entries elsewhere in this status report. + +Our growth wasn’t just in our technology team, but in our advocacy team +too. Here we hired a marketing coordinator and technical writer to provide more +educational and informational content. You’ll see in the *Advocacy and +Education* section below all the work we did to promote FreeBSD, provide +community engagement, education opportunities, and informative content to +help pave the path to getting started with FreeBSD. + +You’ll find out how we used your donations here and in individual entries +throughout this status report. + +We’re passionate about supporting you, the FreeBSD community, but we can’t do it +without your financial support. + +Please consider making a donation to help us continue and increase our support +for FreeBSD in 2021: +link:https://www.FreeBSDfoundation.org/donate/[https://www.FreeBSDfoundation.org/donate/]. + +We also have the Partnership Program, to provide more benefits for our larger +commercial donors. Find out more information at +link:https://www.FreeBSDfoundation.org/FreeBSD-foundation-partnership-program/[https://www.FreeBSDfoundation.org/FreeBSD-foundation-partnership-program/] +and share with your companies! + +==== OS Improvements + +During the third quarter, Foundation staff and grant recipients committed 420 +src tree changes, 24 ports tree changes, and 11 doc tree changes. This +represents 38%, 48%, and 16% of src, port, and doc commits which identify a +sponsor. + *** 1028 LINES SKIPPED *** From nobody Mon Nov 15 16:46:09 2021 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 976A3188D29A for ; Mon, 15 Nov 2021 16:46:10 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HtFSf0CX1z4Z7x; Mon, 15 Nov 2021 16:46:10 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id D5F021D36F; Mon, 15 Nov 2021 16:46:09 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AFGk95I020185; Mon, 15 Nov 2021 16:46:09 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AFGk9Fv020184; Mon, 15 Nov 2021 16:46:09 GMT (envelope-from git) Date: Mon, 15 Nov 2021 16:46:09 GMT Message-Id: <202111151646.1AFGk9Fv020184@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Daniel Ebdrup Jensen Subject: git: 999ad0261c - main - status: Announce the July-September 2021 status report 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: debdrup X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 999ad0261c595eb05ef1649f16f7ca00b3583f46 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by debdrup: URL: https://cgit.FreeBSD.org/doc/commit/?id=999ad0261c595eb05ef1649f16f7ca00b3583f46 commit 999ad0261c595eb05ef1649f16f7ca00b3583f46 Author: Daniel Ebdrup Jensen AuthorDate: 2021-11-15 16:40:55 +0000 Commit: Daniel Ebdrup Jensen CommitDate: 2021-11-15 16:40:55 +0000 status: Announce the July-September 2021 status report --- website/content/en/status/_index.adoc | 3 ++- website/data/en/news/news.toml | 5 +++++ 2 files changed, 7 insertions(+), 1 deletion(-) diff --git a/website/content/en/status/_index.adoc b/website/content/en/status/_index.adoc index 98954adf41..994b4d1916 100644 --- a/website/content/en/status/_index.adoc +++ b/website/content/en/status/_index.adoc @@ -5,7 +5,7 @@ sidenav: about = FreeBSD Status Reports -== Next Quarterly Status Report submissions (July - September) due: September 30th, 2021 +== Next Quarterly Status Report submissions (July - September) due: December 30th, 2021 Submit your entries as Pull Requests from your fork of link:https://github.com/freebsd/freebsd-quarterly[FreeBSD Status Report GitHub repo] or submit them via e-mail to quarterly-submissions@FreeBSD.org, using the link:https://github.com/freebsd/freebsd-quarterly/blob/master/report-sample.adoc[report-sample.adoc template]. @@ -23,6 +23,7 @@ These status reports may be reproduced in whole or in part, as long as the sourc == 2021 +* link:report-2021-07-2021-09/[July, 2021 - September, 2021] * link:report-2021-04-2021-06/[April, 2021 - June, 2021] * link:report-2021-01-2021-03/[January, 2021 - March, 2021] diff --git a/website/data/en/news/news.toml b/website/data/en/news/news.toml index 6fd1aa0b6d..0021dd95ee 100644 --- a/website/data/en/news/news.toml +++ b/website/data/en/news/news.toml @@ -1,5 +1,10 @@ # Sort news by year, month and day +[[news]] +date = "2021-11-15" +title = "July-September 2021 Status Report" +description = "The July to September 2021 Status Report is now available with 42 entries." + [[news]] date = "2021-11-11" title = "FreeBSD 12.3-RC1 Available" From nobody Mon Nov 15 18:01:06 2021 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 1BAD51889597 for ; Mon, 15 Nov 2021 18:01:07 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HtH770Lkmz3GWs; Mon, 15 Nov 2021 18:01:07 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id E15EB1E50A; Mon, 15 Nov 2021 18:01:06 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AFI16Fw026986; Mon, 15 Nov 2021 18:01:06 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AFI16If026985; Mon, 15 Nov 2021 18:01:06 GMT (envelope-from git) Date: Mon, 15 Nov 2021 18:01:06 GMT Message-Id: <202111151801.1AFI16If026985@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Daniel Ebdrup Jensen Subject: git: d4b1dbdb83 - main - status: Correct heading levels 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: debdrup X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: d4b1dbdb8347a34ff8a6b0a7b93dcf7a5116346c Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by debdrup: URL: https://cgit.FreeBSD.org/doc/commit/?id=d4b1dbdb8347a34ff8a6b0a7b93dcf7a5116346c commit d4b1dbdb8347a34ff8a6b0a7b93dcf7a5116346c Author: Daniel Ebdrup Jensen AuthorDate: 2021-11-15 18:00:20 +0000 Commit: Daniel Ebdrup Jensen CommitDate: 2021-11-15 18:00:20 +0000 status: Correct heading levels This fixes the CPE report and its subheadings showing up in the ToC. Reported by: emaste --- website/content/en/status/report-2021-07-2021-09/cpe.adoc | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/website/content/en/status/report-2021-07-2021-09/cpe.adoc b/website/content/en/status/report-2021-07-2021-09/cpe.adoc index 69a43c419f..e2fe9e6d3f 100644 --- a/website/content/en/status/report-2021-07-2021-09/cpe.adoc +++ b/website/content/en/status/report-2021-07-2021-09/cpe.adoc @@ -22,7 +22,7 @@ use it. This is why a script called `chkcpe` was created to validate existing CPE data and find new possible matches automatically. -=== Why do we need it? +==== Why do we need it? It allows comparing CPE URIs for installed packages against published vulnerability data and will give us a much better and @@ -30,7 +30,7 @@ more complete `pkg audit`. As a side effect we will also have a better overview of vulnerable ports in the FreeBSD Ports Collection that need to be patched or updated. -=== How can I help? +==== How can I help? In this phase there is no easy possibility for port maintainers to help. Creating separate PRs only to add CPE data does not make @@ -40,10 +40,9 @@ Right now review and commit consumes around 3 minutes per port. If you are a Ports Committer and want to help please get in touch! -=== Open Tasks +==== Open Tasks * Review remaining reports (~1800) and update ports when appropriate * Improve matching quality to find more possible matches * Support using CPE data in `pkg audit` * Scan for vulnerable ports in the Ports Collection - From nobody Tue Nov 16 06:27:02 2021 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 D7174189FF3C for ; Tue, 16 Nov 2021 06:27:03 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Htbgq1cd1z3knG; Tue, 16 Nov 2021 06:27:03 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 0C945793; Tue, 16 Nov 2021 06:27:03 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AG6R2QF016812; Tue, 16 Nov 2021 06:27:02 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AG6R2J3016811; Tue, 16 Nov 2021 06:27:02 GMT (envelope-from git) Date: Tue, 16 Nov 2021 06:27:02 GMT Message-Id: <202111160627.1AG6R2J3016811@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Wolfram Schneider Subject: git: 5577c806c6 - main - Replace tilde '~' with escaped value %7E in URL description 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: wosch X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 5577c806c62169c29e70e5ac5dd993b67e2899e0 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by wosch: URL: https://cgit.FreeBSD.org/doc/commit/?id=5577c806c62169c29e70e5ac5dd993b67e2899e0 commit 5577c806c62169c29e70e5ac5dd993b67e2899e0 Author: Wolfram Schneider AuthorDate: 2021-11-16 06:24:40 +0000 Commit: Wolfram Schneider CommitDate: 2021-11-16 06:24:40 +0000 Replace tilde '~' with escaped value %7E in URL description e.g. [https://people.freebsd.org/~wosch/build-time/buildworld/] => [https://people.freebsd.org/%7Ewosch/build-time/buildworld/] This is a well known old bug in the hugo framework, see https://github.com/wowchemy/wowchemy-hugo-themes/issues/87 --- .../report-2021-07-2021-09/current-compilation-time-analysis.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/status/report-2021-07-2021-09/current-compilation-time-analysis.adoc b/website/content/en/status/report-2021-07-2021-09/current-compilation-time-analysis.adoc index fc8a4a8e3f..fce908bc31 100644 --- a/website/content/en/status/report-2021-07-2021-09/current-compilation-time-analysis.adoc +++ b/website/content/en/status/report-2021-07-2021-09/current-compilation-time-analysis.adoc @@ -3,7 +3,7 @@ Links: + link:https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=257141[Bug 257141] URL: link:https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=257141[https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=257141] + link:https://lists.freebsd.org/archives/freebsd-current/2021-September/index.html#msg511[Discussion on freebsd-current] URL: link:https://lists.freebsd.org/archives/freebsd-current/2021-September/index.html#msg511[https://lists.freebsd.org/archives/freebsd-current/2021-September/index.html#msg511] + -link:https://people.freebsd.org/~wosch/build-time/buildworld/[Visual chart of buildworld by stages] URL: link:https://people.freebsd.org/~wosch/build-time/buildworld/[https://people.freebsd.org/~wosch/build-time/buildworld/] +link:https://people.freebsd.org/~wosch/build-time/buildworld/[Visual chart of buildworld by stages] URL: link:https://people.freebsd.org/~wosch/build-time/buildworld/[https://people.freebsd.org/%7Ewosch/build-time/buildworld/] Contact: Wolfram Schneider From nobody Wed Nov 17 03:00:13 2021 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 EA99E1897707 for ; Wed, 17 Nov 2021 03:00:13 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Hv72j6KRrz3GfW; Wed, 17 Nov 2021 03:00:13 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id BA61C19688; Wed, 17 Nov 2021 03:00:13 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AH30DNB065564; Wed, 17 Nov 2021 03:00:13 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AH30DE5065553; Wed, 17 Nov 2021 03:00:13 GMT (envelope-from git) Date: Wed, 17 Nov 2021 03:00:13 GMT Message-Id: <202111170300.1AH30DE5065553@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Philip Paeps Subject: git: 6a14c63221 - main - Remove the ftp8.de.freebsd.org mirror 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: philip X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 6a14c63221840f56cd5d60c8d05804f759acba22 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by philip: URL: https://cgit.FreeBSD.org/doc/commit/?id=6a14c63221840f56cd5d60c8d05804f759acba22 commit 6a14c63221840f56cd5d60c8d05804f759acba22 Author: Philip Paeps AuthorDate: 2021-11-17 02:53:03 +0000 Commit: Philip Paeps CommitDate: 2021-11-17 02:59:43 +0000 Remove the ftp8.de.freebsd.org mirror This mirror was removed from the DNS on 2021-11-17. The other mirror hosted by RWTH Aachen (ftp1.de.freebsd.org) is still in service. Reported by: Reinhard Linde --- documentation/content/de/books/handbook/mirrors/_index.adoc | 1 - documentation/content/el/books/handbook/mirrors/_index.adoc | 1 - documentation/content/en/books/handbook/mirrors/_index.adoc | 1 - documentation/content/fr/books/handbook/mirrors/_index.adoc | 1 - documentation/content/hu/books/handbook/mirrors/_index.adoc | 1 - documentation/content/it/books/handbook/mirrors/_index.adoc | 1 - documentation/content/ja/books/handbook/mirrors/_index.adoc | 1 - documentation/content/mn/books/handbook/mirrors/_index.adoc | 1 - documentation/content/nl/books/handbook/mirrors/_index.adoc | 1 - documentation/content/pl/books/handbook/mirrors/_index.adoc | 1 - documentation/content/pt-br/books/handbook/mirrors/_index.adoc | 1 - documentation/content/ru/books/handbook/mirrors/_index.adoc | 1 - documentation/content/zh-cn/books/handbook/mirrors/_index.adoc | 1 - documentation/content/zh-tw/books/handbook/mirrors/_index.adoc | 1 - shared/mirrors.adoc | 1 - 15 files changed, 15 deletions(-) diff --git a/documentation/content/de/books/handbook/mirrors/_index.adoc b/documentation/content/de/books/handbook/mirrors/_index.adoc index ab2d8b1e57..11ba625854 100644 --- a/documentation/content/de/books/handbook/mirrors/_index.adoc +++ b/documentation/content/de/books/handbook/mirrors/_index.adoc @@ -202,7 +202,6 @@ Bei Problemen wenden Sie sich bitte an den Betreuer `<{mirrors-germany-email}>` * ftp://ftp4.de.FreeBSD.org/FreeBSD/ (ftp / http://ftp4.de.FreeBSD.org/pub/FreeBSD/) * ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/ (ftp) * ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/ (ftp / http://ftp7.de.FreeBSD.org/pub/FreeBSD/) -* ftp://ftp8.de.FreeBSD.org/pub/FreeBSD/ (ftp) [[greece]] *{mirrors-greece}* diff --git a/documentation/content/el/books/handbook/mirrors/_index.adoc b/documentation/content/el/books/handbook/mirrors/_index.adoc index 1b21f803f7..c8f284ed13 100644 --- a/documentation/content/el/books/handbook/mirrors/_index.adoc +++ b/documentation/content/el/books/handbook/mirrors/_index.adoc @@ -268,7 +268,6 @@ In case of problems, please contact the hostmaster `<{mirrors-germany-email}>` f * ftp://ftp4.de.FreeBSD.org/FreeBSD/ (ftp / http://ftp4.de.FreeBSD.org/pub/FreeBSD/) * ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/ (ftp) * ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/ (ftp / http://ftp7.de.FreeBSD.org/pub/FreeBSD/) -* ftp://ftp8.de.FreeBSD.org/pub/FreeBSD/ (ftp) [[greece]] *{mirrors-greece}* diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc index d0e34b7f7d..43ce43bed9 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -209,7 +209,6 @@ In case of problems, please contact the hostmaster `<{mirrors-germany-email}>` f * ftp://ftp4.de.FreeBSD.org/FreeBSD/ (ftp / http://ftp4.de.FreeBSD.org/pub/FreeBSD/) * ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/ (ftp) * ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/ (ftp / http://ftp7.de.FreeBSD.org/pub/FreeBSD/) -* ftp://ftp8.de.FreeBSD.org/pub/FreeBSD/ (ftp) [[greece]] *{mirrors-greece}* diff --git a/documentation/content/fr/books/handbook/mirrors/_index.adoc b/documentation/content/fr/books/handbook/mirrors/_index.adoc index 71c92a492e..f9e78d33b9 100644 --- a/documentation/content/fr/books/handbook/mirrors/_index.adoc +++ b/documentation/content/fr/books/handbook/mirrors/_index.adoc @@ -300,7 +300,6 @@ In case of problems, please contact the hostmaster `<{mirrors-germany-email}>` f * ftp://ftp4.de.FreeBSD.org/FreeBSD/ (ftp / http://ftp4.de.FreeBSD.org/pub/FreeBSD/) * ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/ (ftp) * ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/ (ftp / http://ftp7.de.FreeBSD.org/pub/FreeBSD/) -* ftp://ftp8.de.FreeBSD.org/pub/FreeBSD/ (ftp) [[greece]] *{mirrors-greece}* diff --git a/documentation/content/hu/books/handbook/mirrors/_index.adoc b/documentation/content/hu/books/handbook/mirrors/_index.adoc index cbb50ce6fb..9bf70bcae3 100644 --- a/documentation/content/hu/books/handbook/mirrors/_index.adoc +++ b/documentation/content/hu/books/handbook/mirrors/_index.adoc @@ -296,7 +296,6 @@ In case of problems, please contact the hostmaster `<{mirrors-germany-email}>` f * ftp://ftp4.de.FreeBSD.org/FreeBSD/ (ftp / http://ftp4.de.FreeBSD.org/pub/FreeBSD/) * ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/ (ftp) * ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/ (ftp / http://ftp7.de.FreeBSD.org/pub/FreeBSD/) -* ftp://ftp8.de.FreeBSD.org/pub/FreeBSD/ (ftp) [[greece]] *{mirrors-greece}* diff --git a/documentation/content/it/books/handbook/mirrors/_index.adoc b/documentation/content/it/books/handbook/mirrors/_index.adoc index db73a69eb6..13a9f8e6ec 100644 --- a/documentation/content/it/books/handbook/mirrors/_index.adoc +++ b/documentation/content/it/books/handbook/mirrors/_index.adoc @@ -309,7 +309,6 @@ In case of problems, please contact the hostmaster `<{mirrors-germany-email}>` f * ftp://ftp4.de.FreeBSD.org/FreeBSD/ (ftp / http://ftp4.de.FreeBSD.org/pub/FreeBSD/) * ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/ (ftp) * ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/ (ftp / http://ftp7.de.FreeBSD.org/pub/FreeBSD/) -* ftp://ftp8.de.FreeBSD.org/pub/FreeBSD/ (ftp) [[greece]] *{mirrors-greece}* diff --git a/documentation/content/ja/books/handbook/mirrors/_index.adoc b/documentation/content/ja/books/handbook/mirrors/_index.adoc index 3d872794f4..47f026d3f0 100644 --- a/documentation/content/ja/books/handbook/mirrors/_index.adoc +++ b/documentation/content/ja/books/handbook/mirrors/_index.adoc @@ -210,7 +210,6 @@ FreeBSD を anonymous FTP から入手する場合には、近くのサイトを * ftp://ftp4.de.FreeBSD.org/FreeBSD/ (ftp / http://ftp4.de.FreeBSD.org/pub/FreeBSD/) * ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/ (ftp) * ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/ (ftp / http://ftp7.de.FreeBSD.org/pub/FreeBSD/) -* ftp://ftp8.de.FreeBSD.org/pub/FreeBSD/ (ftp) [[greece]] *{mirrors-greece}* diff --git a/documentation/content/mn/books/handbook/mirrors/_index.adoc b/documentation/content/mn/books/handbook/mirrors/_index.adoc index f605fb16de..a8af89e9a4 100644 --- a/documentation/content/mn/books/handbook/mirrors/_index.adoc +++ b/documentation/content/mn/books/handbook/mirrors/_index.adoc @@ -210,7 +210,6 @@ In case of problems, please contact the hostmaster `<{mirrors-germany-email}>` f * ftp://ftp4.de.FreeBSD.org/FreeBSD/ (ftp / http://ftp4.de.FreeBSD.org/pub/FreeBSD/) * ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/ (ftp) * ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/ (ftp / http://ftp7.de.FreeBSD.org/pub/FreeBSD/) -* ftp://ftp8.de.FreeBSD.org/pub/FreeBSD/ (ftp) [[greece]] *{mirrors-greece}* diff --git a/documentation/content/nl/books/handbook/mirrors/_index.adoc b/documentation/content/nl/books/handbook/mirrors/_index.adoc index 5583c759ec..ef02ff2c1d 100644 --- a/documentation/content/nl/books/handbook/mirrors/_index.adoc +++ b/documentation/content/nl/books/handbook/mirrors/_index.adoc @@ -268,7 +268,6 @@ In case of problems, please contact the hostmaster `<{mirrors-germany-email}>` f * ftp://ftp4.de.FreeBSD.org/FreeBSD/ (ftp / http://ftp4.de.FreeBSD.org/pub/FreeBSD/) * ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/ (ftp) * ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/ (ftp / http://ftp7.de.FreeBSD.org/pub/FreeBSD/) -* ftp://ftp8.de.FreeBSD.org/pub/FreeBSD/ (ftp) [[greece]] *{mirrors-greece}* diff --git a/documentation/content/pl/books/handbook/mirrors/_index.adoc b/documentation/content/pl/books/handbook/mirrors/_index.adoc index 7b5d8a6e81..ba4e29800d 100644 --- a/documentation/content/pl/books/handbook/mirrors/_index.adoc +++ b/documentation/content/pl/books/handbook/mirrors/_index.adoc @@ -202,7 +202,6 @@ In case of problems, please contact the hostmaster `<{mirrors-germany-email}>` f * ftp://ftp4.de.FreeBSD.org/FreeBSD/ (ftp / http://ftp4.de.FreeBSD.org/pub/FreeBSD/) * ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/ (ftp) * ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/ (ftp / http://ftp7.de.FreeBSD.org/pub/FreeBSD/) -* ftp://ftp8.de.FreeBSD.org/pub/FreeBSD/ (ftp) [[greece]] *{mirrors-greece}* diff --git a/documentation/content/pt-br/books/handbook/mirrors/_index.adoc b/documentation/content/pt-br/books/handbook/mirrors/_index.adoc index ad25e364e4..bc7dc19226 100644 --- a/documentation/content/pt-br/books/handbook/mirrors/_index.adoc +++ b/documentation/content/pt-br/books/handbook/mirrors/_index.adoc @@ -202,7 +202,6 @@ In case of problems, please contact the hostmaster `<{mirrors-germany-email}>` f * ftp://ftp4.de.FreeBSD.org/FreeBSD/ (ftp / http://ftp4.de.FreeBSD.org/pub/FreeBSD/) * ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/ (ftp) * ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/ (ftp / http://ftp7.de.FreeBSD.org/pub/FreeBSD/) -* ftp://ftp8.de.FreeBSD.org/pub/FreeBSD/ (ftp) [[greece]] *{mirrors-greece}* diff --git a/documentation/content/ru/books/handbook/mirrors/_index.adoc b/documentation/content/ru/books/handbook/mirrors/_index.adoc index eb38c487ed..df2749b42e 100644 --- a/documentation/content/ru/books/handbook/mirrors/_index.adoc +++ b/documentation/content/ru/books/handbook/mirrors/_index.adoc @@ -202,7 +202,6 @@ In case of problems, please contact the hostmaster `<{mirrors-germany-email}>` f * ftp://ftp4.de.FreeBSD.org/FreeBSD/ (ftp / http://ftp4.de.FreeBSD.org/pub/FreeBSD/) * ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/ (ftp) * ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/ (ftp / http://ftp7.de.FreeBSD.org/pub/FreeBSD/) -* ftp://ftp8.de.FreeBSD.org/pub/FreeBSD/ (ftp) [[greece]] *{mirrors-greece}* diff --git a/documentation/content/zh-cn/books/handbook/mirrors/_index.adoc b/documentation/content/zh-cn/books/handbook/mirrors/_index.adoc index e08af9aed5..cd75de58b2 100644 --- a/documentation/content/zh-cn/books/handbook/mirrors/_index.adoc +++ b/documentation/content/zh-cn/books/handbook/mirrors/_index.adoc @@ -294,7 +294,6 @@ In case of problems, please contact the hostmaster `<{mirrors-germany-email}>` f * ftp://ftp4.de.FreeBSD.org/FreeBSD/ (ftp / http://ftp4.de.FreeBSD.org/pub/FreeBSD/) * ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/ (ftp) * ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/ (ftp / http://ftp7.de.FreeBSD.org/pub/FreeBSD/) -* ftp://ftp8.de.FreeBSD.org/pub/FreeBSD/ (ftp) [[greece]] *{mirrors-greece}* diff --git a/documentation/content/zh-tw/books/handbook/mirrors/_index.adoc b/documentation/content/zh-tw/books/handbook/mirrors/_index.adoc index 5ff76e4b54..7844159012 100644 --- a/documentation/content/zh-tw/books/handbook/mirrors/_index.adoc +++ b/documentation/content/zh-tw/books/handbook/mirrors/_index.adoc @@ -202,7 +202,6 @@ In case of problems, please contact the hostmaster `<{mirrors-germany-email}>` f * ftp://ftp4.de.FreeBSD.org/FreeBSD/ (ftp / http://ftp4.de.FreeBSD.org/pub/FreeBSD/) * ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/ (ftp) * ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/ (ftp / http://ftp7.de.FreeBSD.org/pub/FreeBSD/) -* ftp://ftp8.de.FreeBSD.org/pub/FreeBSD/ (ftp) [[greece]] *{mirrors-greece}* diff --git a/shared/mirrors.adoc b/shared/mirrors.adoc index 27ecbdbb7c..96e75fe1f0 100644 --- a/shared/mirrors.adoc +++ b/shared/mirrors.adoc @@ -126,7 +126,6 @@ :mirrors-germany-ftp5: ftp://ftp5.de.FreeBSD.org/pub/FreeBSD/ :mirrors-germany-ftp7: ftp://ftp7.de.FreeBSD.org/pub/FreeBSD/ :mirrors-germany-ftp7-http: http://ftp7.de.FreeBSD.org/pub/FreeBSD/ -:mirrors-germany-ftp8: ftp://ftp8.de.FreeBSD.org/pub/FreeBSD/ :mirrors-germany-email: de-bsd-hubs@de.FreeBSD.org :mirrors-germany: Germany From nobody Wed Nov 17 23:37:52 2021 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 2BC491835439 for ; Wed, 17 Nov 2021 23:37:53 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HvfVn0nV2z3hqm; Wed, 17 Nov 2021 23:37:53 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id EACC722C3; Wed, 17 Nov 2021 23:37:52 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AHNbqKr014926; Wed, 17 Nov 2021 23:37:52 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AHNbq9I014925; Wed, 17 Nov 2021 23:37:52 GMT (envelope-from git) Date: Wed, 17 Nov 2021 23:37:52 GMT Message-Id: <202111172337.1AHNbq9I014925@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: "Danilo G. Baio" Subject: git: d1212ab7e2 - main - Add COPYRIGHT file to the root directory; Update toolchain; 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: dbaio X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: d1212ab7e2f942087d054c1525eaab77ad9b83b3 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by dbaio: URL: https://cgit.FreeBSD.org/doc/commit/?id=d1212ab7e2f942087d054c1525eaab77ad9b83b3 commit d1212ab7e2f942087d054c1525eaab77ad9b83b3 Author: Danilo G. Baio AuthorDate: 2021-10-30 17:14:00 +0000 Commit: Danilo G. Baio CommitDate: 2021-11-17 23:21:41 +0000 Add COPYRIGHT file to the root directory; Update toolchain; Replaces the former toolchain information with the current one. This copyright is currently available on https://www.freebsd.org/copyright/freebsd-doc-license/ or website/content/en/copyright/freebsd-doc-license.adoc. Reviewed by: carlavilla Discussed by: doceng Differential Revision: https://reviews.freebsd.org/D32752 --- COPYRIGHT | 25 ++++++++++++++++++++++ .../content/en/copyright/freebsd-doc-license.adoc | 6 +++--- 2 files changed, 28 insertions(+), 3 deletions(-) diff --git a/COPYRIGHT b/COPYRIGHT new file mode 100644 index 0000000000..9da332f188 --- /dev/null +++ b/COPYRIGHT @@ -0,0 +1,25 @@ +Copyright 1994-2021 The FreeBSD Project. All rights reserved. + +Redistribution and use in source (AsciiDoc) and 'compiled' forms (HTML, PDF, +EPUB and so forth) with or without modification, are permitted provided that +the following conditions are met: + +1. Redistributions of source code (AsciiDoc) must retain the above copyright + notice, this list of conditions and the following disclaimer as the first + lines of this file unmodified. + +2. Redistributions in compiled form (converted to PDF, EPUB and other formats) + must reproduce the above copyright notice, this list of conditions and the + following disclaimer in the documentation and/or other materials provided + with the distribution. + +THIS DOCUMENTATION IS PROVIDED BY THE FREEBSD DOCUMENTATION PROJECT "AS IS" AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE FREEBSD DOCUMENTATION PROJECT BE LIABLE FOR +ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON +ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/website/content/en/copyright/freebsd-doc-license.adoc b/website/content/en/copyright/freebsd-doc-license.adoc index 7c583251e5..d77a733743 100644 --- a/website/content/en/copyright/freebsd-doc-license.adoc +++ b/website/content/en/copyright/freebsd-doc-license.adoc @@ -7,10 +7,10 @@ sidenav: about Copyright 1994-2021 The FreeBSD Project. All rights reserved. -Redistribution and use in source (SGML DocBook) and 'compiled' forms (SGML, HTML, PDF, PostScript, RTF and so forth) with or without modification, are permitted provided that the following conditions are met: +Redistribution and use in source (AsciiDoc) and 'compiled' forms (HTML, PDF, EPUB and so forth) with or without modification, are permitted provided that the following conditions are met: -. Redistributions of source code (SGML DocBook) must retain the above copyright notice, this list of conditions and the following disclaimer as the first lines of this file unmodified. -. Redistributions in compiled form (transformed to other DTDs, converted to PDF, PostScript, RTF and other formats) must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. +. Redistributions of source code (AsciiDoc) must retain the above copyright notice, this list of conditions and the following disclaimer as the first lines of this file unmodified. +. Redistributions in compiled form (Converted to PDF, EPUB and other formats) must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS DOCUMENTATION IS PROVIDED BY THE FREEBSD DOCUMENTATION PROJECT "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FREEBSD DOCUMENTATION PROJECT BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. From nobody Thu Nov 18 00:09:25 2021 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 CCE46188D99B for ; Thu, 18 Nov 2021 00:09:25 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HvgC94sYnz3tGD; Thu, 18 Nov 2021 00:09:25 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 79F5D294B; Thu, 18 Nov 2021 00:09:25 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AI09PZN055320; Thu, 18 Nov 2021 00:09:25 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AI09Pgn055319; Thu, 18 Nov 2021 00:09:25 GMT (envelope-from git) Date: Thu, 18 Nov 2021 00:09:25 GMT Message-Id: <202111180009.1AI09Pgn055319@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: 54bf789fc0 - main - 12.3 schedule: update to reflect RC2 builds have started 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gjb X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 54bf789fc07835b11e7ed7f37b5301c9bad25aec Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=54bf789fc07835b11e7ed7f37b5301c9bad25aec commit 54bf789fc07835b11e7ed7f37b5301c9bad25aec Author: Glen Barber AuthorDate: 2021-11-17 20:56:57 +0000 Commit: Glen Barber CommitDate: 2021-11-18 00:09:12 +0000 12.3 schedule: update to reflect RC2 builds have started Sponsored by: Rubicon Communications, LLC ("Netgate") --- website/content/en/releases/12.3R/schedule.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/releases/12.3R/schedule.adoc b/website/content/en/releases/12.3R/schedule.adoc index 52051181fa..2f6e04221f 100644 --- a/website/content/en/releases/12.3R/schedule.adoc +++ b/website/content/en/releases/12.3R/schedule.adoc @@ -34,7 +34,7 @@ General discussions about the pending release and known issues should be sent to |BETA2 builds begin |28 October 2021 |28 October 2021 |Second beta test snapshot. |BETA3 builds begin |4 November 2021 |4 November 2021 |Third beta test snapshot. |RC1 builds begin |11 November 2021 |11 November 2021 |First release candidate. -|RC2 builds begin |18 November 2021 |- |Second release candidate. +|RC2 builds begin |18 November 2021 |18 November 2021 |Second release candidate. |RC3 builds begin* |25 November 2021 |- |Third release candidate. |RELEASE builds begin |2 December 2021 |- |{localRel}-RELEASE builds begin. |RELEASE announcement |6 December 2021 |- |{localRel}-RELEASE press release. From nobody Thu Nov 18 00:09:26 2021 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 02A9D188D99E for ; Thu, 18 Nov 2021 00:09:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HvgCB6MzJz3tPG; Thu, 18 Nov 2021 00:09:26 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 90CAA299E; Thu, 18 Nov 2021 00:09:26 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AI09Q4V055351; Thu, 18 Nov 2021 00:09:26 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AI09QPh055350; Thu, 18 Nov 2021 00:09:26 GMT (envelope-from git) Date: Thu, 18 Nov 2021 00:09:26 GMT Message-Id: <202111180009.1AI09QPh055350@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: 4ed754f022 - main - 12.3 schedule: reflect MFC requests are no longer being accepted 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gjb X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 4ed754f0225f709610edff43b2322b1e6a536bf5 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=4ed754f0225f709610edff43b2322b1e6a536bf5 commit 4ed754f0225f709610edff43b2322b1e6a536bf5 Author: Glen Barber AuthorDate: 2021-11-17 20:59:50 +0000 Commit: Glen Barber CommitDate: 2021-11-18 00:09:12 +0000 12.3 schedule: reflect MFC requests are no longer being accepted Sponsored by: Rubicon Communications, LLC ("Netgate") --- website/content/en/releases/12.3R/schedule.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/releases/12.3R/schedule.adoc b/website/content/en/releases/12.3R/schedule.adoc index 2f6e04221f..6dc72904f5 100644 --- a/website/content/en/releases/12.3R/schedule.adoc +++ b/website/content/en/releases/12.3R/schedule.adoc @@ -16,7 +16,7 @@ include::shared/en/urls.adoc[] This is the release schedule for FreeBSD {localRel}. For more information about the release engineering process, please see the link:../../../releng/[Release Engineering] section of the web site. General discussions about the pending release and known issues should be sent to the public mailto:FreeBSD-stable@FreeBSD.org[freebsd-stable] mailing list. -//link:{handbook}#mfc-glossary[MFC] requests are no longer being accepted. +link:{handbook}#mfc-glossary[MFC] requests are no longer being accepted. //link:{handbook}#mfc-glossary[MFC] requests should be sent to link:mailto:re@FreeBSD.org[re@FreeBSD.org]. From nobody Thu Nov 18 00:10:26 2021 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 9A1F3188DA16 for ; Thu, 18 Nov 2021 00:10:26 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HvgDL3ky9z3tHM; Thu, 18 Nov 2021 00:10:26 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 602CE2A27; Thu, 18 Nov 2021 00:10:26 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AI0AQ5f063759; Thu, 18 Nov 2021 00:10:26 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AI0AQOK063758; Thu, 18 Nov 2021 00:10:26 GMT (envelope-from git) Date: Thu, 18 Nov 2021 00:10:26 GMT Message-Id: <202111180010.1AI0AQOK063758@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: "Danilo G. Baio" Subject: git: 177d41bc60 - main - website/status: Next report is from October to December 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: dbaio X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 177d41bc6038698266fbc0e082048a2d814a6d7d Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by dbaio: URL: https://cgit.FreeBSD.org/doc/commit/?id=177d41bc6038698266fbc0e082048a2d814a6d7d commit 177d41bc6038698266fbc0e082048a2d814a6d7d Author: Danilo G. Baio AuthorDate: 2021-11-18 00:04:41 +0000 Commit: Danilo G. Baio CommitDate: 2021-11-18 00:10:01 +0000 website/status: Next report is from October to December --- website/content/en/status/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/status/_index.adoc b/website/content/en/status/_index.adoc index 994b4d1916..ee3bf1f92f 100644 --- a/website/content/en/status/_index.adoc +++ b/website/content/en/status/_index.adoc @@ -5,7 +5,7 @@ sidenav: about = FreeBSD Status Reports -== Next Quarterly Status Report submissions (July - September) due: December 30th, 2021 +== Next Quarterly Status Report submissions (October - December) due: December 30th, 2021 Submit your entries as Pull Requests from your fork of link:https://github.com/freebsd/freebsd-quarterly[FreeBSD Status Report GitHub repo] or submit them via e-mail to quarterly-submissions@FreeBSD.org, using the link:https://github.com/freebsd/freebsd-quarterly/blob/master/report-sample.adoc[report-sample.adoc template]. From nobody Thu Nov 18 11:48:39 2021 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 EE41B185444E for ; Thu, 18 Nov 2021 11:48:39 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Hvyjz6GTzz4s5v; Thu, 18 Nov 2021 11:48:39 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id B2957143F2; Thu, 18 Nov 2021 11:48:39 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AIBmdJX086976; Thu, 18 Nov 2021 11:48:39 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AIBmdGk086975; Thu, 18 Nov 2021 11:48:39 GMT (envelope-from git) Date: Thu, 18 Nov 2021 11:48:39 GMT Message-Id: <202111181148.1AIBmdGk086975@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?Q?Fernando Apestegu=C3=ADa?= Subject: git: 470fc627d2 - main - [doc-es][contributing] sync with master 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 470fc627d27488991965394eee25b93526cda745 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=470fc627d27488991965394eee25b93526cda745 commit 470fc627d27488991965394eee25b93526cda745 Author: Fernando Apesteguía AuthorDate: 2021-11-17 15:16:44 +0000 Commit: Fernando Apesteguía CommitDate: 2021-11-18 11:47:01 +0000 [doc-es][contributing] sync with master Also, add missing svn-ports-head mailing list. --- .../content/es/articles/contributing/_index.adoc | 346 ++++++------- .../content/es/articles/contributing/_index.po | 535 +++++++++++---------- shared/es/mailing-lists.adoc | 5 + 3 files changed, 461 insertions(+), 425 deletions(-) diff --git a/documentation/content/es/articles/contributing/_index.adoc b/documentation/content/es/articles/contributing/_index.adoc index 34eea2edf2..63d36a47e2 100644 --- a/documentation/content/es/articles/contributing/_index.adoc +++ b/documentation/content/es/articles/contributing/_index.adoc @@ -1,10 +1,16 @@ --- -title: Contribuir a FreeBSD authors: - - author: Jordan Hubbard - - author: Sam Lawrance - - author: Mark Linimon + - + author: 'Jordan Hubbard' + - + author: 'Sam Lawrance' + - + author: 'Mark Linimon' +description: 'Cómo contribuir al Proyecto FreeBSD' +tags: ["Contributing", "FreeBSD", "Non-Programmer Tasks", "Programmer Tasks"] +title: 'Contribuir a FreeBSD' trademarks: ["freebsd", "ieee", "general"] +weight: 15 --- = Contribuir a FreeBSD @@ -47,15 +53,15 @@ Este artículo describe las diferentes formas en que una persona u organización toc::[] -¿Así que quiere contribuir a FreeBSD? ¡Genial! FreeBSD _depende_ de las contribuciones de su base de usuarios para sobrevivir. Sus contribuciones no solo son gratamente apreciadas, son vitales para que FreeBSD continúe creciendo. +¿Así que quieres contribuir a FreeBSD? ¡Eso es fantástico! FreeBSD _depende_ de las contribuciones de su base de usuarios para sobrevivir. Tus contribuciones no sólo son apreciadas, son vitales para el crecimiento continuo de FreeBSD. El grupo de desarrolladores de FreeBSD lo componen un grupo grande y siempre creciente de gente de todas partes del mundo, de edades y áreas de experiencia técnica muy diversas. Siempre hay más trabajo pendiente que manos disponibles y siempre se agradece ayuda adicional. -El único límite que ponemos a los voluntarios es el que su disponibilidad misma dicte. Por otra parte le pedimos que esté al tanto de lo que otros miembros de la comunidad de FreeBSD esperan de usted. Tener esto en cuenta es importante antes de decidir ser voluntario. +El único límite que ponemos a los voluntarios es el que su disponibilidad misma dicte. Por otra parte le pedimos que esté al tanto de lo que otros miembros de la comunidad de FreeBSD esperan de ti. Tener esto en cuenta es importante antes de decidir ser voluntario. -El proyecto FreeBSD es responsable de mantener un sistema operativo completo, en lugar de un solo kernel o unas pocas utilidades sueltas. Por lo tanto nuestra lista de tareas pendientes [.filename]#TODO# incluye una gran variedad de tareas: desde la documentación, realización de pruebas en las versiones beta, hasta el desarrollo del instalador del sistema y tareas de desarrollo del kernel altamente especializadas. Todo el mundo puede ayudar, independientemente del nivel nivel de habilidad, en un área u otra del proyecto. +El proyecto FreeBSD es responsable de mantener un sistema operativo completo, en lugar de un solo kernel o unas pocas utilidades sueltas. Por lo tanto nuestra lista de tareas pendientes [.filename]#TODO# incluye una gran variedad de tareas: desde la documentación, realización de pruebas en las versiones beta, hasta el desarrollo del instalador del sistema y tareas de desarrollo del kernel altamente especializadas. Todo el mundo puede ayudar, independientemente del nivel de habilidad, en un área u otra del proyecto. -Invitamos a las empresas que tengan proyectos relacionados con FreeBSD a que se pongan en contacto con nosotros. ¿Necesitan de un desarrollo concreto para hacer que su producto funcione? Estaremos encantados de escuchar sus peticiones, siempre y cuando que no sean demasiado raras. ¿Está trabajando en un producto de alto valor añadido? ¡Por favor, háganoslo saber! Podemos trabajar conjuntamente en algunos aspectos del mismo. El mundo del software libre está desafiando muchas de las suposiciones existentes sobre cómo se desarrolla, vende y mantiene el software y le instamos encarecidamente a que al menos considere seriamente su uso. +Invitamos a las empresas que tengan proyectos relacionados con FreeBSD a que se pongan en contacto con nosotros. ¿Necesitan de un desarrollo concreto para hacer que su producto funcione? Estaremos encantados de escuchar sus peticiones, siempre y cuando no sean demasiado raras. ¿Está trabajando en un producto de alto valor añadido? ¡Por favor, háganoslo saber! Podemos trabajar conjuntamente en algunos aspectos del mismo. El mundo del software libre está desafiando muchas de las suposiciones existentes sobre cómo se desarrolla, vende y mantiene el software y le instamos encarecidamente a que al menos considere seriamente su uso. [[contrib-what]] == Qué se necesita @@ -67,46 +73,46 @@ La lista de tareas y subproyectos que se muestra a continuación es una amalgama Muchas de las personas que están involucradas en FreeBSD no son programadores. El proyecto incluye a escritores de documentación, diseñadores web y personas que dan soporte. Todo lo que estas personas necesitan para contribuir es invertir tiempo y la voluntad de aprender. -. Lea cada cierto tiempo las FAQ y el Handbook. Si algo está mal explicado, es ambiguo, está desactualizado o es incorrecto, avísenos. Aún mejor, envíenos una solución (Docbook no es difícil de aprender, pero no hay ningún problema si lo envía en ASCII). -. Ayude a traducir la documentación de FreeBSD a su lengua materna. Si ya existe documentación en su idioma, puede ayudar a traducir otros documentos o comprobar si las traducciones están actualizadas y son correctas. Antes de nada, consulte las extref:{fdp-primer}[FAQ de las traducciones, translations] en el FreeBSD Documentation Project Primer. El hecho de traducir algo no implica la obligación de traducir todo; como voluntario, puede tanto o tan poco como desee. Una vez que alguien empieza a traducir, casi siempre se apunta alguien más. Si solo tiene tiempo o energía para traducir una parte de la documentación, por favor, traduzca las instrucciones de instalación. -. Lea la http://lists.FreeBSD.org/mailman/listinfo/freebsd-questions[lista de correo de preguntas generales de FreeBSD] de vez en cuando (o regularmente, si es posible). Puede ser muy satisfactorio compartir su experiencia y ayudar a las personas a resolver sus problemas ¡A veces incluso puede aprender algo nuevo! Estos foros también pueden ser una fuente de ideas de cosas que puede ser mejoradas. +. Lee cada cierto tiempo las FAQ y el Handbook. Si algo está mal explicado, es ambiguo, está desactualizado o es incorrecto, avísenos. Aún mejor, envíenos una solución (AsciiDoc no es difícil de aprender, pero no hay ningún problema si lo envía en texto plano). +. Ayuda a traducir la documentación de FreeBSD a tu idioma nativo. Si la documentación para tu idioma ya existe, puedes ayudar en la traducción de documentos adicionales o verificar que las traducciones están actualizadas y son correctas. Primero echa un vistazo a extref:{fdp-primer}[Translations FAQ, translations FAQ] en la Introducción a la Documentación del Proyecto FreeBSD. No te estás comprometiendo a traducir tú mismo cada uno de los documentos de FreeBSD - como voluntario, puedes hacer tanto o tan poca traducción como quieras. Una vez que alguien empieza a traducir, otros casi siempre se unen a la causa. Si sólo tienes tiempo o energía para traducir una parte de la documentación, por favor traduce las instrucciones de instalación. +. Lee de vez en cuando (o regularmente) {freebsd-questions}. Puede ser muy satisfactorio compartir tu experiencia y ayudar a la gente a resolver sus problemas; de vez en cuanto ¡podrías aprender algo nuevo tú mismo¡ Estos foros pueden ser también una fuente de ideas sobre cosas que hay que mejorar. [[ongoing-programmer-tasks]] === Tareas en curso para personas que son programadores La mayoría de las tareas aquí expuestas requieren de una considerable cantidad de tiempo, o un conocimiento profundo del kernel de FreeBSD, o ambas cosas. Sin embargo, también hay muchas tareas útiles que son ideales para "hackers de fin de semana". -. Si usa FreeBSD-CURRENT y tiene una buena conexión a Internet, existe una máquina en `current.FreeBSD.org` que genera una release completa una vez al día--de vez en cuando, intente instalar una de estas releases e informe de cualquier problema en el proceso. -. Lea la http://lists.FreeBSD.org/mailman/listinfo/freebsd-bugs[lista de correo de informes de problemas de FreeBSD]. Puede encontrar algún problema sobre el que hacer un comentario constructivo o sobre el que probar parches. O quizás pueda solucionar uno de los problemas usted mismo. -. Si sabe de alguna corrección que ha sido aplicada con éxito en -CURRENT y cuya solución no ha sido aplicada aun en -STABLE después de un período de tiempo razonable (normalmente, un par de semanas) envíe, de forma educada, un mensaje al committer responsable del cambio. +. Si utilizas FreeBSD-CURRENT y tienes una buena conexión a Internet, hay una máquina `current.FreeBSD.org` que construye una versión completa una vez al día de vez en cuando, intenta instalar la última versión y reportar cualquier fallo en el proceso. +. Lee la {freebsd-bugs}. Podría haber un problema sobre el que podrías comentar de forma constructiva o parches que puedes probar. O podrías incluso intentar arreglar tú mismo alguno de los problemas. +. Si sabes de alguna corrección que ha sido aplicada con éxito en -CURRENT y cuya solución no ha sido aplicada aun en -STABLE después de un período de tiempo razonable (normalmente, un par de semanas) envía, de forma educada, un mensaje al committer responsable del cambio. . Mueva el software de terceros a [.filename]#src/contrib# en el árbol del código fuente. -. Asegúrese de que el código de [.filename]#src/contrib# está actualizado. -. Compile el árbol del código fuente (o solo una parte del mismo) con un nivel de depuración adicional habilitado y corrija los warnings. -. Corrija los warnings en los ports que aún utilizan recursos obsoletos como `gets()` o que incluyan [.filename]#malloc.h#. -. Si ha contribuido con algún port y tuvo que hacer cambios específicos para FreeBSD, envíe sus parches a los autores originales (esto les hará la vida más fácil cuando lancen la próxima versión). -. Hágase con copias de estándares formales como POSIX(R). Compare el comportamiento de FreeBSD con el requerido por el estándar. Si el comportamiento difiere, particularmente en áreas sutiles u oscuras de la especificación, envíenos un PR al respecto. Si puede, averigüe cómo solucionarlo e incluya un parche en el PR. Si cree que el estándar es incorrecto, pídale al organismo de estándares que considere su propuesta. -. ¡Sugiera nuevas tareas para esta lista! +. Asegúrate de que el código en [.filename]#src/contrib# está actualizado. +. Construye el árbol de fuentes (o sólo una parte) con los avisos extra activados y límpialos. Una lista de avisos de compilación se puede encontrar también en nuestro https://ci.freebsd.org[CI] seleccionando "LLVM/Clang Warnings". +. Arregla warnings para ports que no marcan como obsoleto el uso de cosas como `gets()` o incluir [.filename]#malloc.h#. +. Si has contribuido con algún port y tuviste que hacer cambios específicos para FreeBSD, envía tus parches a los autores originales (esto les hará la vida más fácil cuando lancen la próxima versión). +. Obtén copias de estándares formales como POSIX(R). Compara el comportamiento de FreeBSD con el requerido por el estándar. Si el comportamiento difiere, en particular en casos esquina y sutiles de la especificación, envía un PR acerca de ello. Si puedes, intenta averiguar cómo arreglarlo e incluye un parche en el PR. Si crees que el estándar está equivocado, pregunta al comité del estándar para que consideren la cuestión. +. ¡Sugiere nuevas tareas para esta lista! -=== Trabaje en la base de datos de PR +=== Trabaja en la base de datos de PR -La https://bugs.FreeBSD.org/search/[lista de PR de FreeBSD] muestra todos los informes de problemas activos y las solicitudes de mejora que los usuarios de FreeBSD han enviado. La base de datos de PR incluye tanto tareas para programadores como para no programadores. Eche un vistazo a los PR abiertos y mire si alguno de ellos le interesa. Algunos pueden ser tareas muy sencillas que solo necesitan una revisión adicional para confirmar que la solución adjunta al PR es la adecuada. Otros pueden ser mucho más complejos, o incluso no incluir una solución. +La https://bugs.FreeBSD.org/search/[lista de PR de FreeBSD] muestra todos los informes de problemas activos y las solicitudes de mejora que los usuarios de FreeBSD han enviado. La base de datos de PR incluye tanto tareas para programadores como para no programadores. Echa un vistazo a los PR abiertos y mire si alguno de ellos le interesa. Algunos pueden ser tareas muy sencillas que solo necesitan una revisión adicional para confirmar que la solución adjunta al PR es la adecuada. Otros pueden ser mucho más complejos, o incluso no incluir una solución. -Comience con los PRs que no han sido asignados a nadie. Si el PR ya ha sido asignado a otra persona, pero cree que puede ayudar, envíe un correo electrónico a la persona que lo tiene asignado y pregúntele si puede colaborar; quizás ya tenga un parche listo para pruebas, o ideas adicionales que proponer. +Comienza con los PRs que no han sido asignados a nadie. Si el PR ya ha sido asignado a otra persona, pero crees que puedes ayudar, envía un correo electrónico a la persona que lo tiene asignado y pregúntale si puedes colaborar; quizás ya tenga un parche listo para pruebas, o ideas adicionales que proponer. === Tareas en curso relacionadas con la colección de ports La colección de ports es un trabajo que está siempre activo. Queremos ofrecer a nuestros usuarios un repositorio de software de terceros fácil de usar, actualizado y de gran calidad. Necesitamos que las personas den parte de su tiempo y esfuerzo para ayudarnos a lograr este objetivo. -Cualquiera puede participar y hay muchas formas diferentes de hacerlo. Contribuir a la colección de ports es una forma excelente de "devolver" algo al proyecto. Si está buscando un trabajo para realizar de forma contínua o un desafío divertido para un día lluvioso estaríamos encantados de que nos ayude. +Cualquiera puede participar y hay muchas formas diferentes de hacerlo. Contribuir a la colección de ports es una forma excelente de "devolver" algo al proyecto. Si estás buscando un trabajo para realizar de forma continua o un desafío divertido para un día lluvioso ¡estaríamos encantados de que nos ayudes! Existen varias formas de ayudar a mantener la colección de ports actualizada y en buen funcionamiento: -* Encuentre algún software interesante o útil y extref:{porters-handbook}[cree un port]. -* Hay una gran cantidad de ports que no tienen un maintainer. Conviertase en un maintainer y <>. -* Si ha creado o adoptado un port tenga en cuenta lo <>. -* Si busca un desafío rápido, puede <>. +* Encuentra algún software útil y chulo y extref:{porters-handbook}[crea un port] para él. +* Hay muchos ports que no tienen mantenedor. Conviértete en mantenedor y <>. +* Si has creado o adoptado un port, considera <>. +* Cuando busques un desafío rápido piensa en <>. -=== Escoja uno de los elementos de la página de ideas +=== Escoge uno de los elementos de la página de ideas La https://wiki.freebsd.org/IdeasPage[lista de proyectos e ideas de FreeBSD para voluntarios] también está disponible para las personas que deseen contribuir al proyecto FreeBSD. Esta lista se actualiza regularmente y contiene elementos para programadores y no programadores, así como información sobre cada proyecto. @@ -118,57 +124,57 @@ Las contribuciones al sistema generalmente pueden catalogarse en las siguientes [[contrib-general]] === Informes de errores y comentarios generales -Una idea o sugerencia técnica de interés general debe enviarse a la http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[lista de correo de discusiones técnicas de FreeBSD]. Del mismo modo, las personas interesadas en estas cosas (¡y una tolerancia para un _gran_ volumen de correo!) pueden subscribirse a la http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[lista de correo de discusiones técnicas de FreeBSD]. Consulte el extref:{handbook}eresources[Handbook de FreeBSD, eresources-mail] para obtener más información sobre esta y otras listas de correo. +Una idea o sugerencia técnica de interés _general_ se debería enviar a {freebsd-hackers}. Igualmente, gente con interés en esas cosas (¡y tolerancia para _altos_ volúmenes de correo!) pueden suscribirse a {freebsd-hackers}. Mira See extref:{handbook}[The FreeBSD Handbook, eresources-mail] para más información acerca de ésta y otras listas de correo. -Si encuentra un error o quiere enviar un cambio concreto puede informar sobre él utilizando el https://bugs.FreeBSD.org/submit/[formulario de envío de errores]. Trate de rellenar cada campo del informe. Incluya el parche directamente en el informe salvo que exceda los 65KB. Si el parche es adecuado para ser añadido al árbol del código fuente incluya `[PATCH]` en la sinopsis del informe. Cuando incluya parches no utilice copiar y pegar, porque copiar y pegar transforma las tabulaciones en espacios, haciendo el parche inútil. Cuando el parche exceda los 20KB por favor comprímalo (por ejemplo, con man:gzip[1] o man:bzip2[1]) antes de enviarlo. +Si encuentras un fallo estás enviando un cambio específico, por favor repórtalo utilizando el https://bugs.FreeBSD.org/submit/[formulario de envío de errores]. Intenta rellenar cada uno de los campos del informe de error. A menos que excedan 65KB, incluye cualquier parche directamente en el reporte. Si el parche puede ser aplicado sobre el árbol de fuentes, pon `[PATCH]`en la sinopsis del informe. Cuando incluyas parches, _no_ utilices copiar y pegar porque copiar y pegar convierte tabuladores en espacios y los hace inutilizables. Cuando los parches son mucho mayores que 20KB, considera comprimirlos (ej. con man:gzip[1] o man:bzip2[1]) antes de subirlos. Tras rellenar el informe debería recibir un mensaje de confirmación junto con un número de seguimiento. Conserve este número de seguimiento para que pueda informarnos con nuevos detalles sobre el problema. -Consulte también extref:{problem-reports}[este artículo] sobre cómo escribir buenos informes de problemas. +Ver también extref:{problem-reports}[este artículo] sobre cómo escribir buenos informes de error. === Cambios en la documentación -Los cambios en la documentación son revisados por los miembros de http://lists.FreeBSD.org/mailman/listinfo/freebsd-doc[la lista de correo del proyecto de documentación de FreeBSD]. Por favor, consulte el extref:{fdp-primer}[FreeBSD Documentation Project Primer] si quiere información detallada. Envíe contribuciones y cambios (¡incluso los más pequeños son bienvenidos!) utilizando el mismo método que cualquier otro informe de errores. +Los cambios en la documentación son revisados por {freebsd-doc}. Por favor, mira extref:{fdp-primer}[FreeBSD Documentation Project Primer] para las instrucciones completas. Envía cambios (¡incluso los pequeños son bienvenidos!) utilizando el mismo método que para cualquier otro informe de error. === Cambios en el código fuente ya existente -Añadir o modificar el código fuente existente es un tema delicado y depende en gran medida de lo obsoleto que esté el desarrollo actual de FreeBSD. Hay una release especial de FreeBSD conocida como "FreeBSD-CURRENT" que está disponible de varias formas para mayor comodidad de los desarrolladores que trabajan activamente en el sistema. Consulte el extref:{handbook}updating-upgrading[Handbook de FreeBSD, current-stable] para obtener más información sobre cómo obtener y usar FreeBSD-CURRENT. +Cambios y añadidos al código fuente existente es un asunto un poco más delicado y depende mucho de cómo de desactualizado te encuentres respecto al desarrollo actual de FreeBSD. Hay una versión especial de FreeBSD en curso denominada "FreeBSD-CURRENT" que está disponible de diversas formas para la conveniencia de los desarrolladores que trabajan activamente en el sistema. Ver See extref:{handbook}[The FreeBSD Handbook, current-stable] para más información acerca de cómo obtener y utilizar FreeBSD-CURRENT. -Por desgracia trabajar con código fuente antiguo significa que a veces sus cambios podrían resultar obsoletos o diferir demasiado para hacer una reintegración en FreeBSD. Esta posibilidad puede minimizarse suscribiéndose a la http://lists.FreeBSD.org/mailman/listinfo/freebsd-announce[lista de anuncios de FreeBSD] y a la http://lists.FreeBSD.org/mailman/listinfo/freebsd-current[lista de correo FreeBSD-CURRENT], donde tienen lugar los debates sobre el estado actual del sistema. +Trabajar con fuentes antiguas significa desafortunadamente que tus cambios podrían estar obsoletos o ser demasiado divergentes como para reintegrarlos fácilmente en FreeBSD. Las posibilidades de que esto suceda se pueden minimizar algo suscribiéndose a las listas freebsd-announce} y {freebsd-current}, donde tienen lugar las discusiones sobre el estado actual del sistema. -Suponiendo que pueda obtener acceso a una versión lo suficientemente actualizada del código fuente del sistema sobre el que realizar sus cambios, el siguiente paso es generar los diffs para enviar a los maintainers de FreeBSD. Esto se realiza con el comando man:diff[1]. +Asumiendo que puedes asegurarte unas fuentes actualizadas sobre la que basar tus cambios, el siguiente paso es producir un conjunto de diffs para enviárselos a los maintainers de FreeBSD. Esto se hace con el comando man:diff[1]. -El formato man:diff[1] recomendado para enviar parches es el formato de salida unificado generado por el comando `diff -u`. +El formato man:diff[1] preferido para enviar parches es el formato de salida unificada generado por `diff -u`. -[source,shell] +[source, shell] .... -% diff -u fichero-antiguo fichero-nuevo +% diff -u oldfile newfile .... o -[source,shell] +[source, shell] .... -% diff -u -r -N directorio-antiguo directorio-nuevo +% diff -u -r -N olddir newdir .... debería generar un conjunto de diffs unificados para el archivo de origen o la jerarquía de directorios. -Consulte el manual de man:diff[1] para obtener más información. +Ver man:diff[1] para más información. -Una vez que tenga el conjunto de diffs (que debería probar con el comando man:patch[1]), debe enviarlos para que sean incluídos en FreeBSD a través de un informe de error. ¡__No envíe__ los diffs a la http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[lista de correo de discusiones técnicas de FreeBSD] o se perderán! Agradecemos inmensamente su colaboración (¡este es un proyecto voluntario!). Estamos muy ocupados por la gran carga de trabajo, por lo tanto, es posible que no podamos abordarlo de inmediato, pero permanecerán en la base de datos de PR hasta que lo hagamos. Etiquete sus envíos incluyendo `[PATCH]` en la sinopsis del informe. +Una vez que tienes un conjunto de diffs (los cuales puedes probar con el comando man:patch[1]), deberías enviarlos como un informe de error para su inclusión en FreeBSD. ¡_No envíes simplemente_ los diffs a {freebsd-hackers} o se perderán! Apreciamos enormemente tu envío (¡este es un proyecto voluntario!); debido a que estamos ocupados, quizás no podamos encargarnos de él inmediatamente pero permanecerá en la base de datos de PR hasta que lo hagamos. Señala tu envío incluyendo `[PATCH]` en la sinopsis del informe. -Si lo considera oportuno (por ejemplo si ha agregado, eliminado o renombrado archivos) empaquete sus cambios en un archivo `tar`. También aceptamos los archivos creados con man:shar[1]. +Si crees que es apropiado (ej: has añadido, borrado o renombrado ficheros), empaqueta tus cambios en un fichero `tar`. Los archivos creados con man:shar[1] también son bienvenidos. -Si sus cambios son delicados, por ejemplo, si no está seguro acerca de los problemas de derechos de autor que regirán su distribución en el futuro, envíelos directamente al Core Team mailto:core@FreeBSD.org[core@FreeBSD.org] en lugar de enviarlo como un informe de error. El Core Team mailto:core@FreeBSD.org[core@FreeBSD.org] es un grupo mucho más pequeño de gente que se encarga de muchas de las tareas diarias de administración del proyecto FreeBSD. Tenga en cuenta que este grupo también está _muy ocupado_ y, por lo tanto, solo debe enviarles correos cuando realmente sea necesario. +Si sus cambios son delicados, por ejemplo, si no está seguro acerca de los problemas de derechos de autor que regirán su distribución en el futuro, envíelos directamente a {core-email} en lugar de enviarlo como un informe de error. El {core-email} es un grupo mucho más pequeño de gente que se encarga de muchas de las tareas diarias de administración del proyecto FreeBSD. Tenga en cuenta que este grupo también está _muy ocupado_ y, por lo tanto, solo debe enviarles correos cuando realmente sea necesario. -Consulte los manuales de man:intro[9] y man:style[9] para obtener más información sobre el estilo de programación requerido. Agradeceríamos que tuviera esa información en cuenta antes de enviar el código. +Por favor consulta man:intro[9] y man:style[9] para más información sobre el estilo del código. Agradeceríamos si al menos fueras consciente de esta información antes de enviar código. === Código nuevo o paquetes de gran valor añadido -En el caso de una contribución significativa o de gran impacto, o si se trata de añadir una nueva característica importante a FreeBSD es necesario enviar los cambios comprimidos en un archivo tar o subirlos a un sitio web o FTP para que otras personas puedan acceder a ellos. Si no tiene acceso a un sitio web o FTP solicitelo en la lista de correo de FreeBSD más adecuada para que alguien busque un sitio para alojar los cambios. +En el caso de una contribución significativa o de gran impacto, o si se trata de añadir una nueva característica importante a FreeBSD es necesario enviar los cambios comprimidos en un archivo tar o subirlos a un sitio web o FTP para que otras personas puedan acceder a ellos. Si no tiene acceso a un sitio web o FTP solicítelo en la lista de correo de FreeBSD más adecuada para que alguien busque un sitio para alojar los cambios. -Cuando se trabaja con grandes cantidades de código, siempre surge el delicado tema del copyright. FreeBSD prefiere licencias de software libre como BSD o ISC. Las licencias de Copyleft como la GPLv2, a veces están permitidas. La lista completa se puede encontrar en la link:https://www.FreeBSD.org/internal/software-license/[página de policita de licencias del core team]. +Cuando se trabaja con grandes cantidades de código, indefectiblemente surge el espinoso asunto de los copyrights. FreeBSD prefiere licencias de software libre como BSD o ISC. Licencias copyleft como GPLv2 a veces también se permiten. La lista completa se puede encontrar en la página link:https://www.FreeBSD.org/internal/software-license/[core team licensing policy]. === Dinero o hardware @@ -177,50 +183,55 @@ Estamos encantados de aceptar donaciones económicas para ayudar a impulsar el p [[donations]] ==== Donar dinero -La FreeBSD Foundation es una fundación sin ánimo de lucro, libre de impuestos, creada para impulsar los objetivos del proyecto FreeBSD. Como entidad 501(c)3, la FreeBSD Foundation está exenta del impuesto federal de la renta de los EEUU así como del Estado de Colorado. Las donaciones a una entidad exenta de impuestos suelen ser deducibles (en los EEUU). +La https://www.freebsdfoundation.org[FreeBSD Foundation] es una fundación sin ánimo de lucro, exenta de impuestos creada para impulsar los objetivos del Proyecto FreeBSD. Como entidad 501(c)3, la Fundación está generalmente exenta de pagar impuestos federales en EE.UU. así como en el Estado de Colorado. Las donaciones a una entidad exenta de pagar impuestos normalmente se pueden deducir de la declaración de impuestos federal. -Las donaciones pueden enviarse mediante cheque a: +Las donaciones se pueden enviar en forma de cheque a: [.address] **** -The FreeBSD Foundation + -3980 Broadway Street + -STE #103-107 + -Boulder CO 80304 + -USA +The FreeBSD Foundation + 3980 Broadway Street + STE #103-107 + Boulder CO 80304 + USA **** -La FreeBSD Foundation también puede aceptar donaciones via web mediante PayPal. Para hacer una donación, visite la https://www.freebsdfoundation.org[página web]. de la FreeBSD Foundation. +La FreeBSD Foundation también acepta https://www.freebsdfoundation.org/donate/[donaciones online] mediante diversas opciones de pago. -Puede encontrar más información sobre la FreeBSD Foundation en https://people.FreeBSD.org/~jdp/foundation/announcement.html[The FreeBSD Foundation -- an Introduction]. Para contactar con la FreeBSD Foundation por correo electrónico, escriba a mailto:info@FreeBSDFoundation.org[info@FreeBSDFoundation.org]. +Se puede encontrar más información acerca de la FreeBSD Foundation en https://people.FreeBSD.org/~jdp/foundation/announcement.html[The FreeBSD Foundation -- an Introduction]. Para contactar con la Fundación por email, escribe a mailto:info@FreeBSDFoundation.org[info@FreeBSDFoundation.org]. ==== Donar hardware -El proyecto FreeBSD acepta encantado donaciones de hardware que le resulten útiles. Si desea donar componentes de hardware por favor póngase en contacto con la link:https://www.FreeBSD.org/donations/[Donations Liaison Office]. +El Proyecto FreeBSD acepta felizmente las donaciones de hardware al que se le puede encontrar un buen uso. Si estás interesado en donar hardware, por favor contacta con la link:https://www.FreeBSD.org/donations/[Oficina del Enlace de Donaciones]. [[ports-contributing]] == Contribuyendo a la colección de ports [[adopt-port]] -=== Adoptar un port que no está mantenido +=== Adopta un port que no está mantenido ==== Elegir un port que no esté mantenido -Asumir el mantenimiento de ports que no están matenidos es una forma excelente de involucrarse. Los ports que no están mantenidos solo se actualizan y arreglan cuando alguien se ofrece como voluntario para trabajar en ellos. Hay una gran cantidad de ports sin mantenimiento. Es una buena idea empezar adoptando un port que use de forma regular. +Asumir el mantenimiento de ports que no están mantenidos es una forma excelente de involucrarse. Los ports que no están mantenidos solo se actualizan y arreglan cuando alguien se ofrece como voluntario para trabajar en ellos. Hay una gran cantidad de ports sin mantenimiento. Es una buena idea empezar adoptando un port que use de forma regular. -Los ports que no están mantenidos tiene como `MAINTAINER` asignado `ports@FreeBSD.org`. Puede ver un listado de todos los ports sin mantenimiento, así como sus errores actuales e informes de problemas en el http://portsmon.FreeBSD.org/portsconcordanceformaintainer.py?maintainer=ports%40FreeBSD.org[FreeBSD Ports Monitoring System]. +Los ports que no están mantenidos tienen su `MAINTAINER` establecido a `ports@FreeBSD.org`. Una lista de ports no mantenidos y sus errores actuales e informes de error se puede ver en el http://portsmon.FreeBSD.org/portsconcordanceformaintainer.py?maintainer=ports%40FreeBSD.org[FreeBSD Ports Monitoring System]. + +En https://portsfallout.com/fallout?port=&maintainer=ports%40FreeBSD.org[PortsFallout] se puede ver una lista de ports no mantenidos con errores. + +Muchos ports no mantenidos pueden tener actualizaciones pendientes, esto se puede ver en el https://portscout.freebsd.org/ports@freebsd.org.html[FreeBSD Ports distfile scanner]. Algunos ports afectan a muchos otros debido a las dependencias y las relaciones con los ports que dependan de ellos. En general, esperamos que las personas tengan algo de experiencia antes de ofrecerse voluntariamente para mantener dichos ports. -Puede comprobar si un port tiene o no dependencias o si otros puertos depende de él consultando el índice maestro de ports, [.filename]#INDEX#. (El nombre del archivo varía según la versión de FreeBSD; por ejemplo, [.filename]#INDEX-8#) Algunos ports tienen dependencias condicionales que no están incluidas en la compilación predeterminada de [.filename]#INDEX#. Esperamos que pueda reconocer dichos ports analizando el archivo [.filename]#Makefile# de otros ports. +Puede comprobar si un port tiene o no dependencias o si otros puertos depende de él consultando el índice maestro de ports, [.filename]#INDEX#.. (El nombre del archivo varía según la versión de FreeBSD; por ejemplo, [.filename]#INDEX#. Algunos ports tienen dependencias condicionales que no están incluidas en la compilación predeterminada de [.filename]#INDEX#. Esperamos que pueda reconocer dichos ports analizando el archivo [.filename]#Makefile# de otros ports. + +[NOTE] +====== +El Sistema de Monitorización de Ports de FreeBSD (portsmon) actualmente no está en funcionamiento debido a las últimas actualizaciones de Python. +====== ==== Cómo adoptar un port -Primero, asegúrese de de comprender cuáles serán sus <>. Lea también el extref:{porters-handbook}[Handbook del Porter]. _Por favor, no se comprometa con más de lo que crea que puede manejar cómodamente._ +Primero asegúrate de que entiendes tu <>. También lee el extref:{porters-handbook}[Porter's Handbook]. _Por favor no te comprometas a más de lo que te sientes cómodo de manejar._ Puede solicitar el mantenimiento de cualquier port que esté sin mantenimiento cuando lo desee. Simplemente configure el parámetro `MAINTAINER` con su propia dirección de correo electrónico y envíe un PR (informe de problemas) con el cambio. Si el port tiene errores de compilación o necesita actualizarse, es posible que desee aprovechar la oportunidad para incluir cualquier otro cambio que se requiera en ese mismo PR. Esto acelerará el proceso, ya que muchos committers no están dispuestos a asignar la responsabilidad del mantenimiento del port a alguien que no tenga un historial de trabajo con FreeBSD. La mejor forma de crear un historial de trabajo es enviando PRs corrigiendo errores de compilación o actualizando ports. -Envíe su PR a la categoría `ports` y utilice la clase `change-request`. Un committer revisará su PR, commiteara los cambios y finalmente cerrará el PR. En algunas ocasiones, este proceso puede llevar cierto tiempo (los committers también son voluntarios :). +Envíe su PR a la categoría `ports`y utilice la clase `change-request`. Un committer revisará su PR, commiteará los cambios y finalmente cerrará el PR. En algunas ocasiones, este proceso puede llevar cierto tiempo (los committers también son voluntarios :). [[maintain-port]] === El desafío para los maintainers de un port @@ -230,76 +241,76 @@ Esta sección le dará una visión general de por qué los ports deben manteners [[why-maintenance]] ==== Por qué los ports requieren mantenimiento -Crear un port es una tarea que se realiza una vez. Pero asegurar que un port esté siempre actualizado y continúe compilandose y ejecutándose correctamente requiere de un esfuerzo de mantenimiento continuo. Los Maintainers son las personas que dedican parte de su tiempo a cumplir estos objetivos. +Crear un port es una tarea que se realiza una vez. Pero asegurar que un port esté siempre actualizado y continúe compilándose y ejecutándose correctamente requiere de un esfuerzo de mantenimiento continuo. Los Maintainers son las personas que dedican parte de su tiempo a cumplir estos objetivos. -La razón principal por la que los ports necesitan mantenimiento es para disponga de las versiones más actualizadas y mejor software de terceros a la comunidad de FreeBSD. Un desafío adicional es mantener los ports para que continuen funcionando dentro del framework de la colección de ports a medida que este evoluciona. +La razón principal por la que los ports necesitan mantenimiento es para disponga de las versiones más actualizadas y mejor software de terceros a la comunidad de FreeBSD. Un desafío adicional es mantener los ports para que continúen funcionando dentro del framework de la colección de ports a medida que este evoluciona. Como maintainer deberá enfrentarse a los siguientes desafíos: -* *Nuevas versiones y actualizaciones de software.* Las nuevas versiones y actualizaciones de software están disponibles todo el tiempo para las aplicaciones que ya han sido portadas, y deben incorporarse a la colección de ports para proporcionar un software actualizado. +* *Nuevas versiones de software y actualizaciones.* Las nuevas versiones y actualizaciones de software están disponibles todo el tiempo para las aplicaciones que ya han sido portadas y deben incorporarse a la colección de ports para proporcionar un software actualizado. -* *Cambios en las dependencias.* Si se realizan cambios significativos en las dependencias de su port es posible que deba actualizarlas para que continúe funcionando correctamente. +* *Cambios en las dependencias.* Si se realizan cambios significativos en las dependencias de tu port es posible que debas actualizarlas para que continúe funcionando correctamente. -* *Cambios que afectan a los ports que dependen de los suyos.* Si otros ports depende de un port que mantiene, los cambios en su port pueden requerir que se coordine con otros maintainers. +* *Cambios que afectan a los ports dependientes.* Si otros ports dependen de un port que tú mantienes, cambios en tu port podrían requerir coordinación con otros maintainers. -* *Interacción con otros usuarios, maintainers y desarrolladores.* Parte de ser maintainer es asumir el rol de proporcionar soporte. No esperamos que de soporte a nivel general (pero aceptaremos gustosos si decide hacerlo). Lo que debe proporcionar es un punto de apoyo para los problemas específicos de FreeBSD que estén relacionados con sus ports. +* *Interacción con otros usuarios, maintainers y desarrolladores.* Una parte de ser maintainer implica tener u rol de apoyo. No se espera de ti que proporciones suporte general (pero damos la bienvenida y escoges hacerlo). Lo que deberías proporcionar es un punto de coordinación para problemas específicos de FreeBSD que atañen a tus ports. -* *Caza de bugs.* Un port puede verse afectado por errores específicos de FreeBSD. Deberá investigar, encontrar y corregir estos errores cuando sean reportados. Es mucho mejor probar meticulosamente un port para identificar todos sus potenciales problemas antes de añadirlo a la colección de ports. +* *Cazar bugs.* Un port puede verse afectado por errores específicos de FreeBSD. Deberá investigar, encontrar y corregir estos errores cuando sean reportados. Es mucho mejor probar meticulosamente un port para identificar todos sus potenciales problemas antes de añadirlo a la Colección de Ports. -* *Cambios en la infraestructura y política de ports.* Ocasionalmente, los sistemas que se utilizan para compilar los ports y paquetes se actualizan o se hace una nueva recomendación que afecta a la infraestructura. Debe tener en cuenta estos cambios en caso de que sus ports se vean afectados y requieran de una actualización. +* *Cambios en la política y la infraestructura de ports.* Ocasionalmente, los sistemas que se utilizan para compilar los ports y paquetes se actualizan o se hace una nueva recomendación que afecta a la infraestructura. Debes tener en cuenta estos cambios en caso de que tus ports se vean afectados y requieran de una actualización. -* *Cambios en el sistema base.* FreeBSD está en constante desarrollo. Los cambios en el software, en las bibliotecas, en el kernel o incluso los cambios en las políticas pueden hacer necesarios ciertos de cambios en los ports. +* *Cambios en el sistema base.* FreeBSD está constantemente bajo desarrollo. Cambios en el software, librerías, el kernel o incluso cambios en las políticas pueden derivar en cambios en los requisitos de los ports. ==== Responsabilidades del maintainer -===== Mantenga sus ports actualizados +===== Mantén sus ports actualizados Esta sección describe el proceso a seguir para mantener sus ports actualizados. -Esto es un resumen. Dispone de más información sobre la actualización de un port en el extref:{porters-handbook}[Handbook del Porter]. +Esto es un resumen. Hay más información disponible acerca de cómo actualizar un port en el extref:{porters-handbook}[Porter's Handbook]. [.procedure] ==== -. Esté atento a las actualizaciones -+ -Monitorice el desarrollo para estar al tanto de nuevas versiones, actualizaciones y correcciones de seguridad. Las listas de correo de anuncios o las páginas web de noticias son útiles para este propósito. En ocasiones los usuarios se pondrán en contacto con usted para preguntarle cuándo se actualizará su port. Si está ocupado con otras cosas o simplemente no puede actualizarlo por alguna razón pregunte al usuario si puede ayudarlo enviándole una actualización. -+ +. Mantente atento a las actualizaciones ++ +Monitoriza el desarrollo para estar al tanto de nuevas versiones, actualizaciones y correcciones de seguridad. Las listas de correo de anuncios o las páginas web de noticias son útiles para este propósito. En ocasiones los usuarios se pondrán en contacto contigo para preguntarte cuándo se actualizará tu port. Si estás ocupado con otras cosas o simplemente no puedes actualizarlo por alguna razón pregunta al usuario si puede ayudarte enviándote una actualización. ++ También puede recibir un correo electrónico automatizado de `FreeBSD Ports Version Check` informándole que ya hay una nueva versión disponible del distfile de su port. En el mensaje se incluirá más información (incluido el cómo dejar de recibir los correos electrónicos en el futuro). . Incorporar cambios -+ -Una vez que estén disponibles incorpore los cambios en el port. Es necesario generar un parche con las diferencias entre el port original y el port actualizado. ++ +Una vez que estén disponibles incorpora los cambios en el port. Es necesario generar un parche con las diferencias entre el port original y el port actualizado. . Revisar y probar -+ -Revise y pruebe a fondo sus cambios: ++ +Revisa y prueba a fondo sus cambios: -** Compile, instale y pruebe su port en tantas plataformas y arquitecturas como pueda. Es común que un port funcione en una rama o plataforma y falle en otra. -** Asegúrese de que las dependencias de su port estén completas. La forma recomendada de hacerlo es instalando su propio tinderbox de ports. Tiene más información en la sección de <>. +** Compila, instala y prueba tu port en tantas plataformas y arquitecturas como puedas. Es común que un port funcione en una rama o plataforma y falle en otra. +** Asegúrate de que las dependencias de tu port están completas. El método recomendado para hacer esto es instalando tu propio tinderbox. Ver <> para más información. ** Compruebe que la lista de componentes del paquete esté actualizada. Esto implica añadir nuevos archivos y directorios, así como eliminar entradas no utilizadas. -** Compruebe su port utilizando man:portlint[1] como guía. Consulte los <> para obtener información importante sobre el uso de portlint. -** Tenga presente la posilidad de que los cambios en su port puedan causar que otros ports dejen de funcionar (se rompan). Si este es el caso coordine los cambios con los maintainers de esos ports. Esto cobra especial importancia si su actualización cambia la versión de la librería compartida; en este caso, como mínimo, los ports que dependan del suyo deberán aumentar de versión su `PORTREVISION` para que puedan actualizarse de forma automática con herramientas como portmaster o man:portupgrade[1]. +** Verifica tu port utilizando man:portlint[1] como guía. Ver <> para información importante acerca del uso de portlint. +** Considera si cambios en tu port pueden provocar que otros ports se rompan. Si es el caso, coordina los cambios con los maintainers de esos ports. Esto es especialmente importante si tus cambios actualizan la versión de una librería compartida; en este caso, como mínimo, los ports dependientes necesitan incrementar su `PORTREVISION`para que sean actualizados automáticamente por las herramientas de automatización como portmaster o man:portupgrade[1]. . Enviar los cambios -+ -Envíe su actualización enviando un PR con una explicación de los cambios y un parque que contenga las diferencias entre el port original y el actualizado. Consulte el artículo extref:{problem-reports}[Cómo enviar informes de problemas de FreeBSD] para obtener más información sobre como escribir un PR correctamente. ++ +Envía tu actualización mediante un PR con una explicación de los cambios y un parche que contenga las diferencias entre el port original y el actualizado. Por favor, consulta extref:{problem-reports}[Writing FreeBSD Problem Reports] para más información sobre cómo escribir un PR realmente bueno. + [NOTE] ====== -No envíe un archivo man:shar[1] de todo el port; en su lugar, utilice el comando man:diff[1] `-ruN`. De esta forma, los committers pueden ver más fácilmente de forma exacta qué cambios se están están realizando. Consulte la sección de extref:{porters-handbook}[actualización, port-upgrading] del Handbook del Porter para más información. +Por favor no envíes un archivo man:shar[1] de todo el port; en su lugar, utiliza man:diff[1] `-ruN`. De este modo, los committers pueden ver mucho más fácilmente qué cambios se están haciendo exactamente. La sección extref:{porters-handbook}[Upgrading, port-upgrading] del Porter's Handbook tiene más información. ====== . Esperar -+ -Llegado el momento un committer se encargará de su PR. Esto puede llevar entre unos minutos y varias semanas, así que tenga paciencia. -. Proporcione feedback -+ -Si un committer encuentra algún problema en sus cambios lo más probable es que se los devuelva. Una respuesta rápida ayudará a que se haga más rápido el commit. Es muy importante mantener abierto el canal de comunicación para acelerar la resolución de cualquier problema. ++ +En algún momento un committer tratará tu PR. Podría llevar minutos, o podría llevar una o dos semanas - así que por favor, sé paciente. Si transcurre más tiempo, por favor busca ayuda en las listas de correo ({freebsd-ports}), IRC: #bsdports en EFNet o #freebsd-ports en Libera por ejemplo. +. Proporciona feedback ++ +Si un committer encuentra algún problema en tus cambios lo más probable es que se los devuelva. Una respuesta rápida ayudará a que se haga más rápido el commit. Es muy importante mantener abierto el canal de comunicación para acelerar la resolución de cualquier problema. . Y para concluir -+ -Se hará el commit con sus cambios y el port habrá sido actualizado. Después se cerrará el PR. ¡Eso es todo! ++ +Se hará el commit con tus cambios y el port habrá sido actualizado. Después se cerrará el PR. ¡Eso es todo! ==== -===== Asegúrese de que sus ports continuan compilando correctamente. +===== Asegúrate de que tus ports continúan compilando correctamente -Esta sección trata sobre descubrir y solucionar problemas que impiden que sus ports se compilen correctamente. +Esta sección trata sobre descubrir y solucionar problemas que impiden que tus ports se compilen correctamente. El proyecto FreeBSD solo garantiza que la colección de ports funcione en la rama `-STABLE`. En teoría debería poder ejecutarse la última versión de cada rama estable (ya que se espera que las ABIs no cambien) pero si funciona también en las demás ramas es aun mejor. @@ -307,136 +318,147 @@ Dado que la mayor parte de las instalaciones de FreeBSD se ejecutan en ordenador [NOTE] ==== -Los fallos habituales para ordenadores que no son `x86` se producen porque los programadores originales asumieron que, por ejemplo, los punteros son `int`s, o que se utilizaría una versión mas antigua del compilador gcc. Cada vez más, los autores de las aplicaciones están reescribiendo su código para eliminar estos fallos -- pero si el autor no mantiene activamente su código, es posible que deba hacerlo usted mismo. +Los fallos habituales para ordenadores que no son `x86` se producen porque los programadores originales asumieron que, por ejemplo, los punteros son `int`s, o que se utilizaría una versión mas antigua del compilador gcc. Cada vez más, los autores de las aplicaciones están reescribiendo su código para eliminar estos fallos — pero si el autor no mantiene activamente su código, es posible que debas hacerlo tú mismo. ==== Estas son las tareas que debe realizar para garantizar que su port pueda compilarse: [.procedure] ==== -. Esté atento a los fallos en la compilación -+ -Revise su correo y busque mensajes de `pkg-fallout@FreeBSD.org` y revise el http://portscout.FreeBSD.org[distfiles scanner] para ver si alguno de los ports que mantiene y que no se está compilando está desactualizado. -. Recopile información -+ -Cuando encuentre algún problema recopile información para ayudar a solucionarlo. Los errores de compilación reportados por `pkg-fallout` incluyen registros que le mostrarán dónde falló la compilación. Si un usuario le informó sobre el fallo pídale que le envíe información que pueda ayudar a identificar el problema, como por ejemplo: +. Mantente atento a los fallos en la compilación ++ +Comprueba tu correo para mensajes de `pkg-fallout@FreeBSD.org` y el http://portscout.FreeBSD.org[distfiles scanner] para ver alguno de los ports que están fallando están desactualizados. +. Recopila información ++ +Cuando encuentres algún problema recopila información para ayudar a solucionarlo. Los errores de compilación reportados por `pkg-fallout` incluyen registros que te mostrarán dónde falló la compilación. Si un usuario te informó sobre el fallo pídele que te envíe información que puedas ayudar a identificar el problema, como por ejemplo: ** Logs de la compilación ** Los comandos y opciones utilizados para compilar el port (incluidas las opciones establecidas en [.filename]#/etc/make.conf#) -** Un listado de los paquetes instalados en su sistema, por ejemplo la salida del comando man:pkg-info[8] -** La versión de FreeBSD que está ejecutando, es decir, la salida del comando man:uname[1] `-a` +** Una lista de paquetes instalados en su sistema tal como los muestra man:pkg-info[8] +** La versión de FreeBSD que están corriendo como la muestra man:uname[1] `-a` ** Cuándo se actualizó por última vez su colección de ports -** Cuándo se actualizó por última vez su árbol de ports e [.filename]#INDEX# +** Cuándo han sido actualizados por última vez su árbol de ports y su [.filename]#INDEX# -. Investigue y encuentre una solución -+ -Lamentablemente no hay un proceso a seguir que sea sencillo. Sin embargo, recuerde que si está atascado puede pedir ayuda. La http://lists.FreeBSD.org/mailman/listinfo/freebsd-ports[lista de correo de los ports de FreeBSD] es un buen sitio para encontrarla, así como los desarrolladores originales del programa. +. Investiga y encuentra una solución ++ +Desgraciadamente no hay un método directo que seguir para hacer esto. De todos modos, recuerda: si te atascas, ¡pide ayuda! La {freebsd-ports} es un buen lugar para empezar, y los desarrolladores del proyecto original suelen ser de mucha ayuda. . Enviar los cambios -+ -Al igual que con la actualización de un port, ahora debe incorporar los cambios, revisar, probar y enviar sus cambios en eun PR y proporcionar feedback si es necesario. ++ +Al igual que con la actualización de un port, ahora debes incorporar los cambios, revisar, probar y enviar tus cambios en eun PR y proporcionar feedback si es necesario. . Enviar parches a los autores originales -+ -En algunos casos necesitará aplicar parches un port para que se ejecute en FreeBSD. Algunos autores originales (aunque no todos) aceptarán incorporar dichos parches en su código en la próxima versión. Si lo hacen esto podría ayudar a los usuarios de otros sistemas BSD y tal vez evitar duplicar esfuerzos. Como cortesía, recomendamos enviar los parches de este tipo a los autores originales. ++ +En algunos casos necesitarás aplicar parches un port para que se ejecute en FreeBSD. Algunos autores originales (aunque no todos) aceptarán incorporar dichos parches en su código en la próxima versión. Si lo hacen esto podría ayudar a los usuarios de otros sistemas BSD y tal vez evitar duplicar esfuerzos. Como cortesía, recomendamos enviar los parches de este tipo a los autores originales. ==== -===== Investigue los informes de errores y PRs relacionados con su port +===== Investiga los informes de errores y PRs relacionados con tu port Esta sección trata sobre encontrar y corregir errores. -Los errores específicos de FreeBSD son causados generalmente por suposiciones sobre los entornos de compilación y ejecución que no afectan a FreeBSD. Es poco probable que encuentre este tipo de problemas, pero pueden ser sutiles y difíciles de diagnosticar. +Los errores específicos de FreeBSD son causados generalmente por suposiciones sobre los entornos de compilación y ejecución que no afectan a FreeBSD. Es poco probable que encuentres este tipo de problemas, pero pueden ser sutiles y difíciles de diagnosticar. Estas son las tareas que debe realizar para garantizar que su port continúe funcionando según lo previsto: [.procedure] ==== -. Responda a los informes de errores -+ -Los errores le pueden llegar por correo electrónico a través del https://bugs.FreeBSD.org/search/[sistema de informe de problemas]. Los usuarios también le pueden informar de los errores directamente. -+ -Debe responder a los PRs y otros reportes en máximo 14 días, pero trate de no demorarse tanto. Intente responder lo antes posible, incluso si es solo para decir que necesita más tiempo antes de empezar a trabajar en el PR. -+ -Si no ha respondido después de 14 días, cualquier committer puede realizar el commit de un PR al que no ha respondido utilizando la regla `maintainer-timeout`. -. Recopile información -+ -Si la persona que informó del error no ha proporcionado una solución es su obligación recopilar la suficiente información para proporcionar una. -+ -Si puede reproducir el error podrá recoger la mayor parte de la información que necesita. Si esto no es posible solicite a la persona que reportó el error que le proporcione la siguiente información: - -** Una descripción detallada de sus acciones, comportamiento esperado del programa y comportamiento real. +. Responde a los informes de errores ++ +Los errores se te pueden reportar a través de email vía la https://bugs.FreeBSD.org/search/[Base de datos de Informes de Error]. Los errores también se te pueden reportar directamente por los usuarios. ++ +Debes responder a los PRs y otros reportes en máximo 14 días, pero trata de no demorarte tanto. Intenta responder lo antes posible, incluso si es solo para decir que necesitas más tiempo antes de empezar a trabajar en el PR. ++ +Si no has respondido en 14 días, cualquier committer mediante un `maintainer-timeout` puede hacer commit desde un PR al que no hayas respondido. +. Recopila información ++ +Si la persona que informó del error no ha proporcionado una solución es tu obligación recopilar la suficiente información para proporcionar una. ++ +Si puedes reproducir el error podrás recoger la mayor parte de la información que necesitas. Si esto no es posible solicita a la persona que reportó el error que te proporcione la siguiente información: + +** Una descripción detallada de sus acciones, comportamiento esperado del programa y comportamiento real ** Una copia de los datos de entrada que producen el error -** Información sobre su entorno de compilación y ejecución, por ejemplo, una lista de los paquetes instalados y la salida del comando man:env[1] +** Información acerca de su entorno de ejecución y compilación - por ejemplo, una lista de paquetes instalados y la salida de man:env[1] ** Core dumps ** Stack traces . Eliminar informes incorrectos -+ -Algunos informes de errores pueden ser incorrectos. Por ejemplo el usuario podría simplemente haber usado mal el programa, o los paquetes que tiene instalados pueden estar desactualizados y necesitan actualizarse. Algunas veces un error reportado no es específico de FreeBSD. En este caso informe del error a los desarrolladores originales del software. Si puede corregir el error también puede aplicar el parche al port para que se aplique antes de la próxima versión original. ++ +Algunos informes de error pueden ser incorrectos. Por ejemplo el usuario podría simplemente haber usado mal el programa, o los paquetes que tiene instalados pueden estar desactualizados y necesitan actualizarse. Algunas veces un error reportado no es específico de FreeBSD. En este caso informa del error a los desarrolladores originales del software. Si puedes corregir el error también puedes aplicar el parche al port para que se aplique antes de la próxima versión original. . Encontrar una solución -+ -Al igual que sucede con los errores de compilación su tarea es encontrar una solución para el problema. Una vez más, tenga presente que si se atasca puede (y debe) pedir ayuda. ++ +Al igual que sucede con los errores de compilación tu tarea es encontrar una solución al problema. Una vez más, ¡recuerda preguntar si te atascas! . Enviar o aprobar cambios -+ -Al igual que sucede con la actualización de un port debe incorporar los cambios, revisar, probar y enviar sus cambios en un PR (o hacer un seguimiento si ya existe un PR para el problema). Si otro usuario ha enviado cambios en el PR también puede enviar un seguimiento diciendo si aprueba o no los cambios. ++ +Al igual que sucede con la actualización de un port debes incorporar los cambios, revisar, probar y enviar tus cambios en un PR (o hacer un seguimiento si ya existe un PR para el problema). Si otro usuario ha enviado cambios en el PR también puedes enviar un seguimiento diciendo si apruebas o no los cambios. ==== ===== Proporcionar ayuda -Parte de las funciones de un maintainer es proporcionar soporte, no para el software en general sino para el port y las peculiaridades y problemas específicos de FreeBSD. Los usuarios pueden contactarle con preguntas, sugerencias, problemas y parches. La mayoría de las veces serán para asuntos específicos de FreeBSD. +Parte de las funciones de un maintainer es proporcionar soporte, no para el software en general sino para el port y las peculiaridades y problemas específicos de FreeBSD. Los usuarios pueden contactarte con preguntas, sugerencias, problemas y parches. La mayoría de las veces serán para asuntos específicos de FreeBSD. -Puede que ocasionalmente tenga que usar sus habilidades diplomáticas y dirigir amablemente a los usuarios que buscan asistencia técnica hacia los recursos apropiados. Alguna que otra vez se encontrará con que alguien le preguntará que por qué los `RPMs` no están actualizados o qué hay que hacer para ejecutar tal software en tal o cual distribución de Linux. Aproveche la oportunidad para decirle que su port está actualizado (si ese es el caso, claro). Y sugiérale que pruebe FreeBSD. +Puede que ocasionalmente tenga que usar sus habilidades diplomáticas y dirigir amablemente a los usuarios que buscan asistencia técnica hacia los recursos apropiados. Alguna que otra vez te encontrarás con que alguien te preguntará que por qué los `RPM`s no están actualizados o qué hay que hacer para ejecutar tal software en tal o cual distribución de Linux. Aprovecha la oportunidad para decirle que tu port está actualizado (si ese es el caso, claro). Y sugiérele que pruebe FreeBSD. -A veces, los usuarios y desarrolladores decidirán que usted es una persona icupada cuyo tiempo es valioso y harán parte del trabajo por usted. Por ejemplo, podrían: +A veces, los usuarios y desarrolladores decidirán que eres una persona ocupada cuyo tiempo es valioso y harán parte del trabajo por ti. Por ejemplo, podrían: -* enviar un PR o enviarle parches para actualizar su port +* enviar un PR o enviarle parches para actualizar tu port * investigar y tal vez proporcionar una solución a un PR o -* incluso enviar cambios para su port. +* incluso enviar cambios para tu port. -En estos casos su obligación principal es responder rápidamente. Una vez más, el tiempo de espera para los maintainers es de 14 días. Después de este período se puede realizar el commit sin aprobación. Se han tomado la molestia de hacerlo por usted, así que por lo menos intente responder lo más rápido posible. Hecho esto, revise, apruebe, modifique o discuta los cambios con ellos lo antes posible. +En estos casos tu obligación principal es responder rápidamente. Una vez más, el tiempo de espera para los maintainers es de 14 días. Después de este período se puede realizar el commit sin aprobación. Se han tomado la molestia de hacerlo por ti, así que por lo menos intenta responder lo más rápido posible. Hecho esto, revisa, aprueba, modifica o discute los cambios con ellos lo antes posible. Si puede hacerles saber que su contribución no cae en saco roto (y así debería ser) será posible que le ayuden en otras ocasiones más adelante :-). [[fix-broken]] === Encontrar y arreglar un port roto -Hay dos lugares realmente buenos para encontrar un port que necesite atención. +Hay algunos lugares realmente buenos para encontrar un port que necesite atención. + +Puedes utilizar el https://bugs.freebsd.org/search[interfaz web] de la base de datos de Informes de Error para buscar y ver PRs sin resolver. La mayoría de los PRs de ports son actualizaciones, pero con una pequeña búsqueda y echando un vistazo a las sinopsis deberías ser capaz de encontrar algo interesante en lo que trabajar (la clase `sw-bug` es un buen sitio para empezar). + +El otro sitio es el http://portsmon.FreeBSD.org/[Sistema de Monitorización de Ports de FreeBSD]. En particular busca ports sin matener con errores de compilación y ports que están marcados como `BROKEN`. + +https://portsfallout.com/[PortsFallout] muestra problemas con los ports recogidos de la construcción de paquetes de FreeBSD. -Puede usar la https://bugs.freebsd.org/search[interfaz web] de la base de datos de informes de problemas para buscar PRs que no están resueltos. La mayoría de los PRs relacionados con ports son actualizaciones, pero con un poco de investigación y hojeando las sinopsis debería encontrar algo interesante en lo que trabajar (la clase `sw-bug` es un buen lugar para empezar). +Está bien mandar cambios para un port que está mantenido, pero recuerda preguntar al mantainer en caso de que ya esté trabajando en el problema. -El otro sitio es el http://portsmon.FreeBSD.org/[FreeBSD Ports Monitoring System]. En particular busque ports que no están mantenidos, con errores de compilación y marcados como `BROKEN`. Es totalmente correcto enviar cambios para un port que está mantenido, pero recuerde preguntar al maintainer para así saber si ya están trabajando en el problema. +Una vez que hayas encontrado un error o problema recopila información, investiga y arréglalo. Si ya existe un PR haz seguimiento del PR. Si no existe un PR créalo. Tus cambios serán revisados. Si son correctos serán aceptados y se hará el commit. -Una vez que haya encontrado un error o problema recopile información, investigue y arréglelo. Si ya existe un PR haga seguimiento del PR. Si no existe un PR créelo. Sus cambios serán revisados. Si son correctos serán aceptados y se hará el commit. +[NOTE] +====== +El Sistema de Monitorización de Ports de FreeBSD (portsmon) actualmente no está en funcionamiento debido a las últimas actualizaciones de Python. +====== [[mortal-coil]] === Cuándo dejarlo -En cualquier caso el Ports Management Team (portmgr) se reserva el derecho a revocar su estatus de maintainer si no ha mantenido activamente su port durante un cierto periodo de tiempo. Actualmente este periodo se establece en 3 meses. Es decir, que transcurran tres meses durante los que haya problemas no resueltos o actualizaciones pendientes que no hayan sido abordadas en tiempo y forma. +Conforme tus intereses y compromisos cambian, podrías encontrar que ya no tienes tiempo para continuar con algunas (o todas) de tus contribuciones a los ports. ¡Está bien! Por favor haznos saber si ya no utilizas un port o si ya no tienes tiempo o has perdido el interés en ser maintainer. De este modo podemos avanzar y permitir que otra gente trabaje en los problemas que existan con el port sin esperar a tu respuesta. Recuerda, FreeBSD es un proyecto voluntario, así que si mantener un port ya no es divertido, ¡probablemente es hora de permitir que otros lo hagan! -En cualquier caso, el Ports Management Team (`portmgr`) se reserva el derecho a revocar su estatus de maintainer si no ha mantenido activamente su port durante un cierto periodo de tiempo. (Actualmente, este periodo se establece en 3 meses). Con esto, queremos decir que haya problemas no resueltos o actualizaciones pendientes que no hayan sido abordadas durante este periodo. +En cualquier caso, el Ports Management Team (`portmgr`) se reserva el derecho a revocar tu estatus de maintainer si no has mantenido activamente su port durante un cierto periodo de tiempo. (Actualmente, este periodo se establece en 3 meses). Con esto, queremos decir que haya problemas no resueltos o actualizaciones pendientes que no hayan sido abordadas durante este periodo. [[resources]] === Recursos para maintainers y colaboradores de los ports -El extref:{porters-handbook}[Handbook del Porter] es su guía de referencia para el sistema de ports. ¡Tengala a mano! +El extref:{porters-handbook}[Porter's Handbook] es tu guía del autoestopista para el sistema de ports. ¡Mantenlo a mano! + +extref:{problem-reports}[Writing FreeBSD Problem Reports] describe como formular y enviar PRs de la mejor forma. ¡En 2005 se enviaron más de once mil PRs de ports! Seguir este artículo nos ayudará a reducir el tiempo necesario para tratar tus PRs. -El artículo extref:{problem-reports}[Cómo enviar informes de problemas de FreeBSD] describe la mejor forma de formular y enviar un PR. ¡En 2005, se enviaron más de once mil PR relacionados con los ports! Seguir este artículo nos ayudará enormemente a reducir el tiempo necesario para lidiar con sus PRs. +La https://bugs.freebsd.org/bugzilla/query.cgi[base de datos de Informes de Error]. -La https://bugs.freebsd.org/bugzilla/query.cgi[base de datos de informes de problemas]. +El http://portsmon.FreeBSD.org/[Sistema de Monitorización de Ports de FreeBSD (portsmon)] puede mostrarte información cruzada acerca de ports como errores de construcción e informes de error. Si eres un maintainer puedes usarlo para comprobar el estado de construcción de tus ports. Como colaborador puedes utilizarlo para encontrar ports rotos o sin mantener que necesitan ser arreglados. -El http://portsmon.FreeBSD.org/[FreeBSD Ports Monitoring System] puede mostrarle información con referencias cruzadas sobre los ports, como errores de compilación e informes de problemas. Si es un maintainer, puede usarlo para verificar el estado de la compilación de sus ports. Como colaborador, puede usarlo para encontrar ports rotos y sin mantenimiento que deban ser reparados. +El http://portscout.FreeBSD.org[Escáner de distfiles de ports de FreeBSD (portscout)] puede mostrarte tus puertos cuyos distfiles no se pueden conseguir. Puedes comprobar tus propios puertos o utilizarlo para encontrar otros ports que necesitan actualizar sus `MASTER_SITES`. -El http://portscout.FreeBSD.org[FreeBSD Ports distfile scanner] puede mostrarle los ports para los cuales los archivos distfiles no están disponibles. Puede usarlo para verificar sus propios ports o para encontrar ports que necesiten actualizar sus `MASTER_SITES`. +package:ports-mgmt/poudriere[] es la forma más rigurosa de probar un port a través del ciclo completo de instalación, empaquetado y desinstalación. La documentación se encuentra en el https://github.com/freebsd/poudriere[repositorio GitHub de poudriere] -package:print/ports-mgmt/poudriere[] es la forma más completa de probar un port a través de todo el ciclo de instalación, empaquetado y desinstalación. La documentación se encuentra en el repositorio de https://github.com/freebsd/poudriere[poudriere en github]. +man:portlint[1] es una aplicación que puede ser utilizada para verificar que tu port cumple con muchas de las importantes directrices funcionales y de estilo. portlint es una aplicación con una heurística simple, así que deberías utilizarla __sólo como una guía__. Si portlint sugiere cambios que no parecen razonables, consulta el extref:{porters-handbook}[Porter's Handbook] o busca consejo. -man:portlint[1] es una aplicación que permite verificar que su port cumple con muchas pautas importantes de estilo y funcionamiento. portlint es una aplicación heurística simple, por lo que __solo debe utilizarla como guía__. Si portlint sugiere cambios que parecen no tener sentido, consulte el extref:{porters-handbook}[Handbook del Porter] o pida consejo. +{freebsd-ports} es para discusiones generales relacionadas con ports. Es un buen sitio para pedir ayuda. Puedes link:https://lists.freebsd.org/[suscribirte, o leer y buscar en el archivo de la lista]. Leer los archivos de {freebsd-ports-bugs} y {svn-ports-head} también podría ser de interés. -La http://lists.FreeBSD.org/mailman/listinfo/freebsd-ports[lista de correo de ports de FreeBSD] está destinada a discusiones generales relacionadas con los ports. Es un buen lugar para pedir ayuda. Puede https://lists.freebsd.org/mailman/listinfo[suscribirse, leer y buscar en los archivos historicos de la lista]. También puede ser de su interés leer los archivos de la http://lists.FreeBSD.org/mailman/listinfo/freebsd-ports-bugs[lista de correo de errores en los ports de FreeBSD] y los http://lists.FreeBSD.org/mailman/listinfo/svn-ports-head[mensajes de commit en el árbol del código fuente de los ports de la rama head/]. +https://portsfallout.com/[PortsFallout] es un sitio para ayudar en la búsqueda del https://lists.freebsd.org/archives/freebsd-pkg-fallout/[archivo de package-fallout de FreeBSD]. [[ideas-contributing]] == Empezar en otras áreas -¿Busca algo interesante para empezar que no haya sido mencionado en el artículo? El proyecto FreeBSD tiene varias páginas en la wiki que contienen áreas dentro de las cuales las nuevas personas que tengan interes en contribuir pueden obtener ideas sobre cómo empezar. +¿Buscas algo interesante para empezar que no haya sido mencionado en el artículo? El proyecto FreeBSD tiene varias páginas en la wiki que contienen áreas dentro de las cuales las nuevas personas que tengan interés en contribuir pueden obtener ideas sobre cómo empezar. -La página https://wiki.freebsd.org/JuniorJobs[Junior Jobs] tiene una lista de proyectos que pueden ser de interés para las personas que acaban de empezar a usar FreeBSD y desean trabajar en cosas interesantes por primera vez. +La página https://wiki.freebsd.org/JuniorJobs[Junior Jobs] tiene una lista de proyectos que podrían ser de interés para gente que está empezando con FreeBSD y quiere trabajar en cosas interesantes para introducirse. -La https://wiki.freebsd.org/IdeasPage[Ideas Page] contiene propuestas sobre cosas que "sería bueno tener" o son "interesantes" para trabajar en el proyecto. +La página https://wiki.freebsd.org/IdeasPage[Ideas Page] contiene varias cosas que "sería bueno tener" o "interesantes" para trabajar en el Proyecto. diff --git a/documentation/content/es/articles/contributing/_index.po b/documentation/content/es/articles/contributing/_index.po index aff97884db..3b1b2576c0 100644 --- a/documentation/content/es/articles/contributing/_index.po +++ b/documentation/content/es/articles/contributing/_index.po @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2021-08-23 14:30-0300\n" -"PO-Revision-Date: 2021-09-28 16:28+0000\n" +"POT-Creation-Date: 2021-11-04 20:26-0300\n" +"PO-Revision-Date: 2021-11-17 15:13+0000\n" "Last-Translator: Fernando Apesteguía \n" "Language-Team: Spanish \n" @@ -15,7 +15,7 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=n != 1;\n" -"X-Generator: Weblate 4.8\n" +"X-Generator: Weblate 4.8.1\n" #. type: YAML Front Matter: description #: documentation/content/en/articles/contributing/_index.adoc:1 @@ -31,12 +31,23 @@ msgid "Contributing to FreeBSD" msgstr "Contribuir a FreeBSD" #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:40 +#: documentation/content/en/articles/contributing/_index.adoc:33 +msgid "" +"include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/" +"{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists.adoc[] " +"include::shared/{{% lang %}}/urls.adoc[]" +msgstr "" +"include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/{{" +"% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists.adoc[] " +"include::shared/{{% lang %}}/urls.adoc[]" + +#. type: Plain text +#: documentation/content/en/articles/contributing/_index.adoc:46 msgid "Abstract" msgstr "Resumen" #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:42 +#: documentation/content/en/articles/contributing/_index.adoc:48 msgid "" "This article describes the different ways in which an individual or " "organization may contribute to the FreeBSD Project." @@ -45,12 +56,12 @@ msgstr "" "organización puede contribuir al proyecto FreeBSD." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:44 +#: documentation/content/en/articles/contributing/_index.adoc:50 msgid "'''" msgstr "'''" #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:49 +#: documentation/content/en/articles/contributing/_index.adoc:55 msgid "" "So you want to contribute to FreeBSD? That is great! FreeBSD _relies_ on the " "contributions of its user base to survive. Your contributions are not only " @@ -62,7 +73,7 @@ msgstr "" "continuo de FreeBSD." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:52 +#: documentation/content/en/articles/contributing/_index.adoc:58 msgid "" "A large and growing number of international contributors, of greatly varying " "ages and areas of technical expertise, develop FreeBSD. There is always " @@ -75,7 +86,7 @@ msgstr "" "manos disponibles y siempre se agradece ayuda adicional." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:56 +#: documentation/content/en/articles/contributing/_index.adoc:62 msgid "" "As a volunteer, what you do is limited only by what you want to do. " "However, we do ask that you are aware of what other members of the FreeBSD " @@ -88,7 +99,7 @@ msgstr "" "importante antes de decidir ser voluntario." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:60 +#: documentation/content/en/articles/contributing/_index.adoc:66 msgid "" "The FreeBSD project is responsible for an entire operating system " "environment, rather than just a kernel or a few scattered utilities. As " @@ -106,7 +117,7 @@ msgstr "" "independientemente del nivel de habilidad, en un área u otra del proyecto." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:65 +#: documentation/content/en/articles/contributing/_index.adoc:71 msgid "" "Commercial entities engaged in FreeBSD-related enterprises are also " "encouraged to contact us. Do you need a special extension to make your " @@ -128,13 +139,13 @@ msgstr "" "al menos considere seriamente su uso." #. type: Title == -#: documentation/content/en/articles/contributing/_index.adoc:67 +#: documentation/content/en/articles/contributing/_index.adoc:73 #, no-wrap msgid "What Is Needed" msgstr "Qué se necesita" #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:70 +#: documentation/content/en/articles/contributing/_index.adoc:76 msgid "" "The following list of tasks and sub-projects represents something of an " "amalgam of various [.filename]#TODO# lists and user requests." @@ -143,13 +154,13 @@ msgstr "" "amalgama de varias listas de [.filename]#TODO# y solicitudes de los usuarios." #. type: Title === -#: documentation/content/en/articles/contributing/_index.adoc:72 +#: documentation/content/en/articles/contributing/_index.adoc:78 #, no-wrap msgid "Ongoing Non-Programmer Tasks" msgstr "Tareas en curso para personas que no son programadores" #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:77 +#: documentation/content/en/articles/contributing/_index.adoc:83 msgid "" "Many people who are involved in FreeBSD are not programmers. The Project " "includes documentation writers, Web designers, and support people. All that " @@ -162,7 +173,7 @@ msgstr "" "necesitan para contribuir es invertir tiempo y la voluntad de aprender." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:79 +#: documentation/content/en/articles/contributing/_index.adoc:85 msgid "" "Read through the FAQ and Handbook periodically. If anything is poorly " "explained, ambiguous, out of date or incorrect, let us know. Even better, " @@ -175,33 +186,33 @@ msgstr "" "problema si lo envía en texto plano)." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:80 +#: documentation/content/en/articles/contributing/_index.adoc:86 msgid "" "Help translate FreeBSD documentation into your native language. If " "documentation already exists for your language, you can help translate " "additional documents or verify that the translations are up-to-date and " -"correct. First take a look at the link:{fdp-primer}" -"#translations[Translations FAQ] in the FreeBSD Documentation Project Primer. " -"You are not committing yourself to translating every single FreeBSD document " -"by doing this - as a volunteer, you can do as much or as little translation " -"as you desire. Once someone begins translating, others almost always join " -"the effort. If you only have the time or energy to translate one part of the " +"correct. First take a look at the extref:{fdp-primer}[Translations FAQ, " +"translations] in the FreeBSD Documentation Project Primer. You are not " +"committing yourself to translating every single FreeBSD document by doing " +"this - as a volunteer, you can do as much or as little translation as you " +"desire. Once someone begins translating, others almost always join the " +"effort. If you only have the time or energy to translate one part of the " "documentation, please translate the installation instructions." msgstr "" "Ayuda a traducir la documentación de FreeBSD a tu idioma nativo. Si la " "documentación para tu idioma ya existe, puedes ayudar en la traducción de " "documentos adicionales o verificar que las traducciones están actualizadas y " -"son correctas. Primero echa un vistazo a link:{fdp-primer}" -"#translations[Translations FAQ] en la Introducción a la Documentación del " -"Proyecto FreeBSD. No te estás comprometiendo a traducir tú mismo cada uno de " -"los documentos de FreeBSD - como voluntario, puedes hacer tanto o tan poca " +"son correctas. Primero echa un vistazo a extref:{fdp-primer}[Translations " +"FAQ, translations FAQ] en la Introducción a la Documentación del Proyecto " +"FreeBSD. No te estás comprometiendo a traducir tú mismo cada uno de los " +"documentos de FreeBSD - como voluntario, puedes hacer tanto o tan poca " "traducción como quieras. Una vez que alguien empieza a traducir, otros casi " "siempre se unen a la causa. Si sólo tienes tiempo o energía para traducir " "una parte de la documentación, por favor traduce las instrucciones de " "instalación." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:81 +#: documentation/content/en/articles/contributing/_index.adoc:87 msgid "" "Read the {freebsd-questions} occasionally (or even regularly). It can be " "very satisfying to share your expertise and help people solve their " @@ -214,13 +225,13 @@ msgstr "" "foros pueden ser también una fuente de ideas sobre cosas que hay que mejorar." #. type: Title === -#: documentation/content/en/articles/contributing/_index.adoc:83 +#: documentation/content/en/articles/contributing/_index.adoc:89 #, no-wrap msgid "Ongoing Programmer Tasks" msgstr "Tareas en curso para personas que son programadores" #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:87 +#: documentation/content/en/articles/contributing/_index.adoc:93 msgid "" "Most of the tasks listed here may require a considerable investment of time, " "an in-depth knowledge of the FreeBSD kernel, or both. However, there are " @@ -232,7 +243,7 @@ msgstr "" "para \"hackers de fin de semana\"." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:89 +#: documentation/content/en/articles/contributing/_index.adoc:95 msgid "" "If you run FreeBSD-CURRENT and have a good Internet connection, there is a " "machine `current.FreeBSD.org` which builds a full release once a day-every " @@ -245,7 +256,7 @@ msgstr "" "cualquier fallo en el proceso." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:90 +#: documentation/content/en/articles/contributing/_index.adoc:96 msgid "" "Read the {freebsd-bugs}. There may be a problem you can comment " "constructively on or with patches you can test. Or you could even try to fix " @@ -256,7 +267,7 @@ msgstr "" "incluso intentar arreglar tú mismo alguno de los problemas." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:91 +#: documentation/content/en/articles/contributing/_index.adoc:97 msgid "" "If you know of any bug fixes which have been successfully applied to -" "CURRENT but have not been merged into -STABLE after a decent interval " @@ -268,7 +279,7 @@ msgstr "" "un mensaje al committer responsable del cambio." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:92 +#: documentation/content/en/articles/contributing/_index.adoc:98 msgid "" "Move contributed software to [.filename]#src/contrib# in the source tree." msgstr "" @@ -276,13 +287,13 @@ msgstr "" "código fuente." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:93 +#: documentation/content/en/articles/contributing/_index.adoc:99 msgid "Make sure code in [.filename]#src/contrib# is up to date." msgstr "" "Asegúrate de que el código en [.filename]#src/contrib# está actualizado." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:94 +#: documentation/content/en/articles/contributing/_index.adoc:100 msgid "" "Build the source tree (or just part of it) with extra warnings enabled and " "clean up the warnings. A list of build warnings can also be found from our " @@ -295,7 +306,7 @@ msgstr "" "Warnings\"." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:95 +#: documentation/content/en/articles/contributing/_index.adoc:101 msgid "" "Fix warnings for ports which do deprecated things like using `gets()` or " "including [.filename]#malloc.h#." @@ -304,7 +315,7 @@ msgstr "" "`gets()` o incluir [.filename]#malloc.h#." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:96 +#: documentation/content/en/articles/contributing/_index.adoc:102 msgid "" "If you have contributed any ports and you had to make FreeBSD-specific " "changes, send your patches back to the original authors (this will make your " @@ -315,7 +326,7 @@ msgstr "" "vida más fácil cuando lancen la próxima versión)." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:97 +#: documentation/content/en/articles/contributing/_index.adoc:103 msgid "" "Get copies of formal standards like POSIX(R). Compare FreeBSD's behavior to " "that required by the standard. If the behavior differs, particularly in " @@ -331,18 +342,18 @@ msgstr "" "comité del estándar para que consideren la cuestión." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:98 +#: documentation/content/en/articles/contributing/_index.adoc:104 msgid "Suggest further tasks for this list!" msgstr "¡Sugiere nuevas tareas para esta lista!" #. type: Title === -#: documentation/content/en/articles/contributing/_index.adoc:99 +#: documentation/content/en/articles/contributing/_index.adoc:105 #, no-wrap msgid "Work through the PR Database" msgstr "Trabaja en la base de datos de PR" #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:106 +#: documentation/content/en/articles/contributing/_index.adoc:112 msgid "" "The https://bugs.FreeBSD.org/search/[FreeBSD PR list] shows all the current " "active problem reports and requests for enhancement that have been submitted " @@ -363,7 +374,7 @@ msgstr "" "complejos, o incluso no incluir una solución." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:109 +#: documentation/content/en/articles/contributing/_index.adoc:115 msgid "" "Start with the PRs that have not been assigned to anyone else. If a PR is " "assigned to someone else, but it looks like something you can handle, email " @@ -378,13 +389,13 @@ msgstr "" "que proponer." #. type: Title === -#: documentation/content/en/articles/contributing/_index.adoc:110 +#: documentation/content/en/articles/contributing/_index.adoc:116 #, no-wrap msgid "Ongoing Ports Tasks" msgstr "Tareas en curso relacionadas con la colección de ports" #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:115 +#: documentation/content/en/articles/contributing/_index.adoc:121 msgid "" "The Ports Collection is a perpetual work in progress. We want to provide " "our users with an easy to use, up to date, high quality repository of third " @@ -397,7 +408,7 @@ msgstr "" "de su tiempo y esfuerzo para ayudarnos a lograr este objetivo." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:119 +#: documentation/content/en/articles/contributing/_index.adoc:125 msgid "" "Anyone can get involved, and there are lots of different ways to do so. " "Contributing to ports is an excellent way to help \"give back\" something to " @@ -411,7 +422,7 @@ msgstr "" "de que nos ayudes!" #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:121 +#: documentation/content/en/articles/contributing/_index.adoc:127 msgid "" "There are a number of easy ways you can contribute to keeping the ports tree " "up to date and in good working order:" @@ -420,16 +431,16 @@ msgstr "" "y en buen funcionamiento:" #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:123 +#: documentation/content/en/articles/contributing/_index.adoc:129 msgid "" -"Find some cool or useful software and link:{porters-handbook}[create a port] " -"for it." +"Find some cool or useful software and extref:{porters-handbook}[create a " +"port] for it." msgstr "" -"Encuentra algún software útil y chulo y link:{porters-handbook}[crea un " +"Encuentra algún software útil y chulo y extref:{porters-handbook}[crea un " "port] para él." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:124 +#: documentation/content/en/articles/contributing/_index.adoc:130 msgid "" "There are a large number of ports that have no maintainer. Become a " "maintainer and <>." @@ -438,23 +449,23 @@ msgstr "" "<>." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:125 +#: documentation/content/en/articles/contributing/_index.adoc:131 msgid "If you have created or adopted a port, be aware of <>." msgstr "Si has creado o adoptado un port, considera <>." #. type: Plain text -#: documentation/content/en/articles/contributing/_index.adoc:126 +#: documentation/content/en/articles/contributing/_index.adoc:132 msgid "When you are looking for a quick challenge you could <>." *** 1453 LINES SKIPPED *** From nobody Thu Nov 18 15:26:26 2021 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 92670188AE4B for ; Thu, 18 Nov 2021 15:26:29 +0000 (UTC) (envelope-from debdrup@freebsd.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2610:1c1:1:6074::16:84]) (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 "freefall.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Hw3YK3pJFz3JsW for ; Thu, 18 Nov 2021 15:26:29 +0000 (UTC) (envelope-from debdrup@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1637249189; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=RUfzR+wzPflKGNVv3N1oXZ8Xo6Ghz2kkVCR5Nfiqzb4=; b=E1V1S1TPcDKXXNjzVhrcIQKIs998Ici90ZA23lGSz2kqWeHbusCNiNO6uPOUUWL8XU2hfM YZhvk1zoGABFEOM8CUDMPL+AZBOEB8Z46sCvnmoyfwJPDIsS84qCSGqqbaZoYowh2Fgz3W XgppifnkH7a7yLq98g8PR6d2ZqlA+lCTpI/NJVpGIib0duNqA3loFRCtQQjdYtGYhTgYVC 8hewTvF58xCYYpyfQfkATA9/mXD6gUQ+6SeACetVI8GgmHyNiDZl1yaOmwkvuURPpmtm60 dVxWm573p35VO76lIo1cJRsSEfGsuOqAJCrBcSBdnAMbQ5dWBMdImOnbdo+KsA== Received: by freefall.freebsd.org (Postfix, from userid 1471) id 5C478B512; Thu, 18 Nov 2021 15:26:29 +0000 (UTC) Date: Thu, 18 Nov 2021 16:26:26 +0100 From: Daniel Ebdrup Jensen To: dev-commits-doc-all@FreeBSD.org Subject: Re: git: 177d41bc60 - main - website/status: Next report is from October to December Message-ID: <20211118152626.25ycd2plcsw62d5j@nerd-thinkpad.local> Mail-Followup-To: Daniel Ebdrup Jensen , dev-commits-doc-all@FreeBSD.org References: <202111180010.1AI0AQOK063758@gitrepo.freebsd.org> 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 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="akhfekgcjxlgsqnu" Content-Disposition: inline In-Reply-To: <202111180010.1AI0AQOK063758@gitrepo.freebsd.org> ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1637249189; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=RUfzR+wzPflKGNVv3N1oXZ8Xo6Ghz2kkVCR5Nfiqzb4=; b=q21xUGxyq4qm1QfUBKotBoFRqXzAWpkfjuhJuyxJxTVe0gVXmA3Y8+EUebWKr1fTREjodD xwxvweoiBBet74Zq/ecAGbfKqrWywSYTmMIYXN7J40iakgMvo1QlnD+wcsQioYvicIL/p8 mG0aHJUwHlo+9OLzO2qfrcNEpfcC6BKRij7ccUjxCvIV1Xf2AweJq8IhsquLujmF/bHWm/ tnhcYh9M94DwKxfE+1E4y0R2cCEZCkDpENB1mjCFC3ACl+zEQpv9Zj/0OcjwTIGUzwMbUO joHgIsu+GE0QFckAw0Z6nlQT4C+mvbnDrMSml3TgCUEsTJ6uGV4uip4F799WJA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1637249189; a=rsa-sha256; cv=none; b=aZS8vu/kmALvdZO68lUa44u+at7IxMIr51LpP/QFZ5zgMTNYPZ4fVtaHLKQnGHJ6pcInkW 5fi3mjmMSEWzQdQzeGA62h48xOeDMv/6QvNLUPAmcSvrzcX+7vE8JFBQ+BMHrzY2XcntgR 9sF/7Z+/US30gh8Gy+20OGuZtQ0J5Gbj82UUHaNeb/E/eYSX08skn5ttoM3ClVSnfoS8by zLpBhg5jItEwdFWR0jSSn21Gv+ayBOFFfQud50wiNe3wpd0YO1i+32KR+FeKR3mI1rdDOq XcN2L6Rb1V75pn72ggshMDS4bavcIITZV6VQjumpUNK6WKEP6EpiV/5gfHyX/g== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N --akhfekgcjxlgsqnu Content-Type: text/plain; charset=us-ascii; format=flowed Content-Disposition: inline On Thu, Nov 18, 2021 at 12:10:26AM +0000, Danilo G. Baio wrote: >The branch main has been updated by dbaio: > >URL: https://cgit.FreeBSD.org/doc/commit/?id=177d41bc6038698266fbc0e082048a2d814a6d7d > >commit 177d41bc6038698266fbc0e082048a2d814a6d7d >Author: Danilo G. Baio >AuthorDate: 2021-11-18 00:04:41 +0000 >Commit: Danilo G. Baio >CommitDate: 2021-11-18 00:10:01 +0000 > > website/status: Next report is from October to December >--- > website/content/en/status/_index.adoc | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > >diff --git a/website/content/en/status/_index.adoc b/website/content/en/status/_index.adoc >index 994b4d1916..ee3bf1f92f 100644 >--- a/website/content/en/status/_index.adoc >+++ b/website/content/en/status/_index.adoc >@@ -5,7 +5,7 @@ sidenav: about > > = FreeBSD Status Reports > >-== Next Quarterly Status Report submissions (July - September) due: December 30th, 2021 >+== Next Quarterly Status Report submissions (October - December) due: December 30th, 2021 > > Submit your entries as Pull Requests from your fork of link:https://github.com/freebsd/freebsd-quarterly[FreeBSD Status Report GitHub repo] or submit them via e-mail to quarterly-submissions@FreeBSD.org, using the link:https://github.com/freebsd/freebsd-quarterly/blob/master/report-sample.adoc[report-sample.adoc template]. > Hi folks, So it is. Probably means I deserve a pointy hat. ;) Yours, Daniel Ebdrup Jensen --akhfekgcjxlgsqnu Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQGTBAABCgB9FiEEDonNJPbg/JLIMoS6Ps5hSHzN87oFAmGWcKJfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDBF ODlDRDI0RjZFMEZDOTJDODMyODRCQTNFQ0U2MTQ4N0NDREYzQkEACgkQPs5hSHzN 87oaYgf6AtvmSeu7pTgzbOP+AiZzVZByVmEnHmE8yZJZMk9kb/Ei6Cl5m9yrgLOE BhLPq+g8Tx5KyUiE/FURT2xUC3cVWA/meNi9I7E7/60gDTraGX7T3d6WcSoLCvux 10nO0dKQM5YQQ0oP5rNHF38iO2Z7O12fSakkIe10aI1SSilyCS1lc3aSyuzVqar7 k0H7ThZ8gEgJr/VvPI3HgCIQeRrim3SPrxxSXnFyYz5/CosW0qj0fZjcLhiByHiO jWVc+1b52hZBNc1VC5cy/Eu4Odv33eao6t8jvZ+olq+GK6b4QBEka+P8XEhiWPfa yf5f0eOOAHbTR2aEkhmWHiEYPVOl9Q== =8FQ+ -----END PGP SIGNATURE----- --akhfekgcjxlgsqnu-- From nobody Thu Nov 18 22:37:06 2021 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 6D52E188E07E for ; Thu, 18 Nov 2021 22:37:12 +0000 (UTC) (envelope-from pauamma@gundo.com) Received: from mail.gundo.com (gibson.gundo.com [75.145.166.65]) by mx1.freebsd.org (Postfix) with ESMTP id 4HwF6J2CqSz4SvK; Thu, 18 Nov 2021 22:37:12 +0000 (UTC) (envelope-from pauamma@gundo.com) Received: from webmail.gundo.com (variax.gundo.com [75.145.166.70]) by mail.gundo.com (Postfix) with ESMTP id 682A34C0714; Thu, 18 Nov 2021 16:37:06 -0600 (CST) 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 Date: Thu, 18 Nov 2021 22:37:06 +0000 From: Pau Amma To: Daniel Ebdrup Jensen , dev-commits-doc-all@freebsd.org Subject: Re: git: 177d41bc60 - main - website/status: Next report is from October to December In-Reply-To: <20211118152626.25ycd2plcsw62d5j@nerd-thinkpad.local> References: <202111180010.1AI0AQOK063758@gitrepo.freebsd.org> <20211118152626.25ycd2plcsw62d5j@nerd-thinkpad.local> User-Agent: Roundcube Webmail/1.4.8 Message-ID: <611fa6d334e6a18df41a6f4757a2d0f3@gundo.com> X-Sender: pauamma@gundo.com Content-Type: text/plain; charset=US-ASCII; format=flowed Content-Transfer-Encoding: 7bit X-Rspamd-Queue-Id: 4HwF6J2CqSz4SvK X-Spamd-Bar: ---- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[] X-ThisMailContainsUnwantedMimeParts: N On 2021-11-18 15:26, Daniel Ebdrup Jensen wrote: > On Thu, Nov 18, 2021 at 12:10:26AM +0000, Danilo G. Baio wrote: >> The branch main has been updated by dbaio: >> >> URL: >> https://cgit.FreeBSD.org/doc/commit/?id=177d41bc6038698266fbc0e082048a2d814a6d7d >> >> commit 177d41bc6038698266fbc0e082048a2d814a6d7d >> Author: Danilo G. Baio >> AuthorDate: 2021-11-18 00:04:41 +0000 >> Commit: Danilo G. Baio >> CommitDate: 2021-11-18 00:10:01 +0000 >> >> website/status: Next report is from October to December >> --- >> website/content/en/status/_index.adoc | 2 +- >> 1 file changed, 1 insertion(+), 1 deletion(-) >> >> diff --git a/website/content/en/status/_index.adoc >> b/website/content/en/status/_index.adoc >> index 994b4d1916..ee3bf1f92f 100644 >> --- a/website/content/en/status/_index.adoc >> +++ b/website/content/en/status/_index.adoc >> @@ -5,7 +5,7 @@ sidenav: about >> >> = FreeBSD Status Reports >> >> -== Next Quarterly Status Report submissions (July - September) due: >> December 30th, 2021 >> +== Next Quarterly Status Report submissions (October - December) due: >> December 30th, 2021 > > Hi folks, > > So it is. > > Probably means I deserve a pointy hat. ;) Only if it's a party hat and comes with a... blanking out on the word, noisemaker that unrolls and extends when you blow into the mouthpiece. You amply deserve both for herding this update along. From nobody Thu Nov 18 22:51:51 2021 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 CCD8818949F5 for ; Thu, 18 Nov 2021 22:51:54 +0000 (UTC) (envelope-from dbaio@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 4HwFRG5F9Bz4XSG; Thu, 18 Nov 2021 22:51:54 +0000 (UTC) (envelope-from dbaio@FreeBSD.org) Received: from auth1-smtp.messagingengine.com (auth1-smtp.messagingengine.com [66.111.4.227]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) (Authenticated sender: dbaio/mail) by smtp.freebsd.org (Postfix) with ESMTPSA id 905552CC3B; Thu, 18 Nov 2021 22:51:54 +0000 (UTC) (envelope-from dbaio@FreeBSD.org) Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailauth.nyi.internal (Postfix) with ESMTP id 5C39527C005B; Thu, 18 Nov 2021 17:51:54 -0500 (EST) Received: from mailfrontend1 ([10.202.2.162]) by compute1.internal (MEProxy); Thu, 18 Nov 2021 17:51:54 -0500 X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvuddrfeejgddtvdcutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc fjughrpeffhffvuffkfhggtggujgesghdtreertddtvdenucfhrhhomhepfdffrghnihhl ohcuifdruceurghiohdfuceouggsrghioheshfhrvggvuefuffdrohhrgheqnecuggftrf grthhtvghrnhepjeffueelfeffhffgudefvdeiieejjedtteevleelteelheeugefgfffg keeutdelnecuffhomhgrihhnpehfrhgvvggsshgurdhorhhgpdhgihhthhhusgdrtghomh enucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpegusggr ihhoodhmvghsmhhtphgruhhthhhpvghrshhonhgrlhhithihqdduudekudefleduvddtqd dvieektddvjeeikedquggsrghioheppefhrhgvvgeuufffrdhorhhgsehfrghsthhmrghi lhdrtghomh X-ME-Proxy: Received: by mail.messagingengine.com (Postfix) with ESMTPA; Thu, 18 Nov 2021 17:51:53 -0500 (EST) Date: Thu, 18 Nov 2021 19:51:51 -0300 From: "Danilo G. Baio" To: Daniel Ebdrup Jensen , dev-commits-doc-all@FreeBSD.org Subject: Re: git: 177d41bc60 - main - website/status: Next report is from October to December Message-ID: <20211118225151.m4zwuse247kecuvm@t480.local> References: <202111180010.1AI0AQOK063758@gitrepo.freebsd.org> <20211118152626.25ycd2plcsw62d5j@nerd-thinkpad.local> 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 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="ay3ug4fmkqy5ngtt" Content-Disposition: inline In-Reply-To: <20211118152626.25ycd2plcsw62d5j@nerd-thinkpad.local> X-ThisMailContainsUnwantedMimeParts: N --ay3ug4fmkqy5ngtt Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, Nov 18, 2021 at 04:26:26PM +0100, Daniel Ebdrup Jensen wrote: > On Thu, Nov 18, 2021 at 12:10:26AM +0000, Danilo G. Baio wrote: > > The branch main has been updated by dbaio: > >=20 > > URL: https://cgit.FreeBSD.org/doc/commit/?id=3D177d41bc6038698266fbc0e0= 82048a2d814a6d7d > >=20 > > commit 177d41bc6038698266fbc0e082048a2d814a6d7d > > Author: Danilo G. Baio > > AuthorDate: 2021-11-18 00:04:41 +0000 > > Commit: Danilo G. Baio > > CommitDate: 2021-11-18 00:10:01 +0000 > >=20 > > website/status: Next report is from October to December > > --- > > website/content/en/status/_index.adoc | 2 +- > > 1 file changed, 1 insertion(+), 1 deletion(-) > >=20 > > diff --git a/website/content/en/status/_index.adoc b/website/content/en= /status/_index.adoc > > index 994b4d1916..ee3bf1f92f 100644 > > --- a/website/content/en/status/_index.adoc > > +++ b/website/content/en/status/_index.adoc > > @@ -5,7 +5,7 @@ sidenav: about > >=20 > > =3D FreeBSD Status Reports > >=20 > > -=3D=3D Next Quarterly Status Report submissions (July - September) due= : December 30th, 2021 > > +=3D=3D Next Quarterly Status Report submissions (October - December) d= ue: December 30th, 2021 > >=20 > > Submit your entries as Pull Requests from your fork of link:https://git= hub.com/freebsd/freebsd-quarterly[FreeBSD Status Report GitHub repo] or sub= mit them via e-mail to quarterly-submissions@FreeBSD.org, using the link:ht= tps://github.com/freebsd/freebsd-quarterly/blob/master/report-sample.adoc[r= eport-sample.adoc template]. > >=20 >=20 > Hi folks, >=20 > So it is. >=20 > Probably means I deserve a pointy hat. ;) >=20 > Yours, > Daniel Ebdrup Jensen I don't think so. Your work is very appreciated; we need to thank you and all people involved in making this report happen. Thank you! --=20 Danilo G. Baio (dbaio) --ay3ug4fmkqy5ngtt Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQKTBAABCgB9FiEEORj0UTsjzCy+enIkmpN7LfMuiNcFAmGW2QNfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDM5 MThGNDUxM0IyM0NDMkNCRTdBNzIyNDlBOTM3QjJERjMyRTg4RDcACgkQmpN7LfMu iNdfpBAAuhRRtl6OG+trq6RsUL2D3SmOh4ky4e9oTPs6vC1W9oFq0C0AyFoH2YoB GQxYUqDj443i5E5N+axYZPch53mJQJzEmJE/x+2CAAdgfsUbDkQJvZTvICcC2sKM FiSx2HrkcjTT7gvSKPriKbIJKo9KSBKoYfmmgT0wpCcNuEIQe5KBEpZAebN6Igui QjmnjGr7R21SSC3i0gvIzNF6bxKjcPelQndmjo41/TcJoI8emstZ2QHi0X5osayQ ADFftkUjxiFJ4XW2llC7DcZlyp9t/4aae/BiIehvWfdL5TdTcdOKiNO+1hJH75cz R8wDllG9bL7n8EYDWsZ+STc3DzVFQNvGtiK/fNTnPkaYjWoNmxLTtkT9wQbdq00d 4CIC35RBLP5KmgkP5aVG1fxrnSnurfmxegBTdWQ13mmjVNrBoR8jNLD/MFMKiNPz Y+0YCIZ5o6co/aiXaixVnHXv0feMVW0jz9F3v9lMloS/gNZUb3v/cjjtagIGTkn2 4OEQkzNk7b3+DDwNr/kxBbrMrp+8OnIw1Pn0RoFQsgZA9cMwDjWkhwKl6TCvDIGK 1Hx9oThsiJR9TL9yLktqjSVeJXamJmpXE+mQmNPY4g7avXyc43ziW8hAChfexp8P +xlPuPKLeUkYX2WY2k096ZErFk/4C2hJymiKbYBDSHlk4rCWVH4= =iNIM -----END PGP SIGNATURE----- --ay3ug4fmkqy5ngtt-- From nobody Fri Nov 19 00:15:33 2021 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 5504E1899AF5 for ; Fri, 19 Nov 2021 00:15:34 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HwHHn6b1Mz3QhJ; Fri, 19 Nov 2021 00:15:33 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 5DF1E1E943; Fri, 19 Nov 2021 00:15:33 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AJ0FXLr086353; Fri, 19 Nov 2021 00:15:33 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AJ0FXYC086352; Fri, 19 Nov 2021 00:15:33 GMT (envelope-from git) Date: Fri, 19 Nov 2021 00:15:33 GMT Message-Id: <202111190015.1AJ0FXYC086352@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: "Bjoern A. Zeeb" Subject: git: 977ffe1f1b - main - Document __FreeBSD_version 1300521 (LinuxKPI and net80211 MFCs). 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bz X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 977ffe1f1bb251724b18539907cd7817f60cb889 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by bz (src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=977ffe1f1bb251724b18539907cd7817f60cb889 commit 977ffe1f1bb251724b18539907cd7817f60cb889 Author: Bjoern A. Zeeb AuthorDate: 2021-11-19 00:11:04 +0000 Commit: Bjoern A. Zeeb CommitDate: 2021-11-19 00:11:04 +0000 Document __FreeBSD_version 1300521 (LinuxKPI and net80211 MFCs). Sponsored by: The FreeBSD Foundation --- .../content/en/books/porters-handbook/versions/_index.adoc | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/documentation/content/en/books/porters-handbook/versions/_index.adoc b/documentation/content/en/books/porters-handbook/versions/_index.adoc index 4389df105a..83209563c5 100644 --- a/documentation/content/en/books/porters-handbook/versions/_index.adoc +++ b/documentation/content/en/books/porters-handbook/versions/_index.adoc @@ -1083,6 +1083,12 @@ Template: |gitref:fe2827f1678b8ff0baf62a1529b2cc121a25b090[repository="src",length=12] |October 21, 2021 |13.0-STABLE after extending the AES-CCM and Chacha20-Poly1305 ciphers in OCF to support multiple nonce lengths. + +|1300521 +|gitref:29745cf91cfc22afa94da0ce43e07a6dc377f631[repository="src",length=12] +|November 19, 2021 +|13.0-STABLE after various merges to LinuxKPI and net80211. + |=== //// From nobody Fri Nov 19 01:24:17 2021 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 686AF189C3D4 for ; Fri, 19 Nov 2021 01:24:17 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HwJq52Pcqz4XR1; Fri, 19 Nov 2021 01:24:17 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 322C71F3CE; Fri, 19 Nov 2021 01:24:17 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AJ1OHtF079137; Fri, 19 Nov 2021 01:24:17 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AJ1OHMt079136; Fri, 19 Nov 2021 01:24:17 GMT (envelope-from git) Date: Fri, 19 Nov 2021 01:24:17 GMT Message-Id: <202111190124.1AJ1OHMt079136@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: bfe8268183 - main - 12.3: Announce 12.3-RC2 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gjb X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: bfe8268183ec9b5597f7fcfd17a66603e46f5fd9 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=bfe8268183ec9b5597f7fcfd17a66603e46f5fd9 commit bfe8268183ec9b5597f7fcfd17a66603e46f5fd9 Author: Glen Barber AuthorDate: 2021-11-19 01:23:48 +0000 Commit: Glen Barber CommitDate: 2021-11-19 01:24:13 +0000 12.3: Announce 12.3-RC2 Sponsored by: Rubicon Communications, LLC ("Netgate") --- shared/releases.adoc | 2 +- .../CHECKSUM.SHA256-FreeBSD-12.3-RC1-amd64-vm.asc | 23 ---------------- .../CHECKSUM.SHA256-FreeBSD-12.3-RC1-amd64.asc | 29 -------------------- ...SUM.SHA256-FreeBSD-12.3-RC1-arm-armv6-RPI-B.asc | 20 -------------- ....SHA256-FreeBSD-12.3-RC1-arm-armv7-BANANAPI.asc | 20 -------------- ...HA256-FreeBSD-12.3-RC1-arm-armv7-BEAGLEBONE.asc | 20 -------------- ...HA256-FreeBSD-12.3-RC1-arm-armv7-CUBIEBOARD.asc | 20 -------------- ...A256-FreeBSD-12.3-RC1-arm-armv7-CUBIEBOARD2.asc | 20 -------------- ...eeBSD-12.3-RC1-arm-armv7-CUBOX-HUMMINGBOARD.asc | 20 -------------- ...SHA256-FreeBSD-12.3-RC1-arm-armv7-GENERICSD.asc | 20 -------------- ...KSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-RPI2.asc | 20 -------------- ...SHA256-FreeBSD-12.3-RC1-arm-armv7-WANDBOARD.asc | 20 -------------- ...6-FreeBSD-12.3-RC1-arm64-aarch64-PINE64-LTS.asc | 20 -------------- ...HA256-FreeBSD-12.3-RC1-arm64-aarch64-PINE64.asc | 20 -------------- ....SHA256-FreeBSD-12.3-RC1-arm64-aarch64-RPI3.asc | 20 -------------- ...UM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64-vm.asc | 23 ---------------- ...CKSUM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64.asc | 29 -------------------- .../CHECKSUM.SHA256-FreeBSD-12.3-RC1-i386-vm.asc | 23 ---------------- .../CHECKSUM.SHA256-FreeBSD-12.3-RC1-i386.asc | 29 -------------------- ...M.SHA256-FreeBSD-12.3-RC1-powerpc-powerpc64.asc | 29 -------------------- ....SHA256-FreeBSD-12.3-RC1-powerpc-powerpcspe.asc | 29 -------------------- .../CHECKSUM.SHA256-FreeBSD-12.3-RC1-powerpc.asc | 29 -------------------- .../CHECKSUM.SHA256-FreeBSD-12.3-RC1-sparc64.asc | 25 ----------------- .../CHECKSUM.SHA256-FreeBSD-12.3-RC2-amd64-vm.asc | 23 ++++++++++++++++ .../CHECKSUM.SHA256-FreeBSD-12.3-RC2-amd64.asc | 29 ++++++++++++++++++++ ...SUM.SHA256-FreeBSD-12.3-RC2-arm-armv6-RPI-B.asc | 20 ++++++++++++++ ....SHA256-FreeBSD-12.3-RC2-arm-armv7-BANANAPI.asc | 20 ++++++++++++++ ...HA256-FreeBSD-12.3-RC2-arm-armv7-CUBIEBOARD.asc | 20 ++++++++++++++ ...A256-FreeBSD-12.3-RC2-arm-armv7-CUBIEBOARD2.asc | 20 ++++++++++++++ ...eeBSD-12.3-RC2-arm-armv7-CUBOX-HUMMINGBOARD.asc | 20 ++++++++++++++ ...SHA256-FreeBSD-12.3-RC2-arm-armv7-GENERICSD.asc | 20 ++++++++++++++ ...KSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-RPI2.asc | 20 ++++++++++++++ ...SHA256-FreeBSD-12.3-RC2-arm-armv7-WANDBOARD.asc | 20 ++++++++++++++ ...6-FreeBSD-12.3-RC2-arm64-aarch64-PINE64-LTS.asc | 20 ++++++++++++++ ...HA256-FreeBSD-12.3-RC2-arm64-aarch64-PINE64.asc | 20 ++++++++++++++ ...UM.SHA256-FreeBSD-12.3-RC2-arm64-aarch64-vm.asc | 23 ++++++++++++++++ ...CKSUM.SHA256-FreeBSD-12.3-RC2-arm64-aarch64.asc | 29 ++++++++++++++++++++ .../CHECKSUM.SHA256-FreeBSD-12.3-RC2-i386-vm.asc | 23 ++++++++++++++++ .../CHECKSUM.SHA256-FreeBSD-12.3-RC2-i386.asc | 29 ++++++++++++++++++++ ...M.SHA256-FreeBSD-12.3-RC2-powerpc-powerpc64.asc | 29 ++++++++++++++++++++ ....SHA256-FreeBSD-12.3-RC2-powerpc-powerpcspe.asc | 29 ++++++++++++++++++++ .../CHECKSUM.SHA256-FreeBSD-12.3-RC2-powerpc.asc | 29 ++++++++++++++++++++ .../CHECKSUM.SHA256-FreeBSD-12.3-RC2-sparc64.asc | 25 +++++++++++++++++ .../CHECKSUM.SHA512-FreeBSD-12.3-RC1-amd64-vm.asc | 23 ---------------- .../CHECKSUM.SHA512-FreeBSD-12.3-RC1-amd64.asc | 29 -------------------- ...SUM.SHA512-FreeBSD-12.3-RC1-arm-armv6-RPI-B.asc | 20 -------------- ....SHA512-FreeBSD-12.3-RC1-arm-armv7-BANANAPI.asc | 20 -------------- ...HA512-FreeBSD-12.3-RC1-arm-armv7-BEAGLEBONE.asc | 20 -------------- ...HA512-FreeBSD-12.3-RC1-arm-armv7-CUBIEBOARD.asc | 20 -------------- ...A512-FreeBSD-12.3-RC1-arm-armv7-CUBIEBOARD2.asc | 20 -------------- ...eeBSD-12.3-RC1-arm-armv7-CUBOX-HUMMINGBOARD.asc | 20 -------------- ...SHA512-FreeBSD-12.3-RC1-arm-armv7-GENERICSD.asc | 20 -------------- ...KSUM.SHA512-FreeBSD-12.3-RC1-arm-armv7-RPI2.asc | 20 -------------- ...SHA512-FreeBSD-12.3-RC1-arm-armv7-WANDBOARD.asc | 20 -------------- ...2-FreeBSD-12.3-RC1-arm64-aarch64-PINE64-LTS.asc | 20 -------------- ...HA512-FreeBSD-12.3-RC1-arm64-aarch64-PINE64.asc | 20 -------------- ....SHA512-FreeBSD-12.3-RC1-arm64-aarch64-RPI3.asc | 20 -------------- ...UM.SHA512-FreeBSD-12.3-RC1-arm64-aarch64-vm.asc | 23 ---------------- ...CKSUM.SHA512-FreeBSD-12.3-RC1-arm64-aarch64.asc | 29 -------------------- .../CHECKSUM.SHA512-FreeBSD-12.3-RC1-i386-vm.asc | 23 ---------------- .../CHECKSUM.SHA512-FreeBSD-12.3-RC1-i386.asc | 29 -------------------- ...M.SHA512-FreeBSD-12.3-RC1-powerpc-powerpc64.asc | 29 -------------------- ....SHA512-FreeBSD-12.3-RC1-powerpc-powerpcspe.asc | 29 -------------------- .../CHECKSUM.SHA512-FreeBSD-12.3-RC1-powerpc.asc | 29 -------------------- .../CHECKSUM.SHA512-FreeBSD-12.3-RC1-sparc64.asc | 25 ----------------- .../CHECKSUM.SHA512-FreeBSD-12.3-RC2-amd64-vm.asc | 23 ++++++++++++++++ .../CHECKSUM.SHA512-FreeBSD-12.3-RC2-amd64.asc | 29 ++++++++++++++++++++ ...SUM.SHA512-FreeBSD-12.3-RC2-arm-armv6-RPI-B.asc | 20 ++++++++++++++ ....SHA512-FreeBSD-12.3-RC2-arm-armv7-BANANAPI.asc | 20 ++++++++++++++ ...HA512-FreeBSD-12.3-RC2-arm-armv7-CUBIEBOARD.asc | 20 ++++++++++++++ ...A512-FreeBSD-12.3-RC2-arm-armv7-CUBIEBOARD2.asc | 20 ++++++++++++++ ...eeBSD-12.3-RC2-arm-armv7-CUBOX-HUMMINGBOARD.asc | 20 ++++++++++++++ ...SHA512-FreeBSD-12.3-RC2-arm-armv7-GENERICSD.asc | 20 ++++++++++++++ ...KSUM.SHA512-FreeBSD-12.3-RC2-arm-armv7-RPI2.asc | 20 ++++++++++++++ ...SHA512-FreeBSD-12.3-RC2-arm-armv7-WANDBOARD.asc | 20 ++++++++++++++ ...2-FreeBSD-12.3-RC2-arm64-aarch64-PINE64-LTS.asc | 20 ++++++++++++++ ...HA512-FreeBSD-12.3-RC2-arm64-aarch64-PINE64.asc | 20 ++++++++++++++ ...UM.SHA512-FreeBSD-12.3-RC2-arm64-aarch64-vm.asc | 23 ++++++++++++++++ ...CKSUM.SHA512-FreeBSD-12.3-RC2-arm64-aarch64.asc | 29 ++++++++++++++++++++ .../CHECKSUM.SHA512-FreeBSD-12.3-RC2-i386-vm.asc | 23 ++++++++++++++++ .../CHECKSUM.SHA512-FreeBSD-12.3-RC2-i386.asc | 29 ++++++++++++++++++++ ...M.SHA512-FreeBSD-12.3-RC2-powerpc-powerpc64.asc | 29 ++++++++++++++++++++ ....SHA512-FreeBSD-12.3-RC2-powerpc-powerpcspe.asc | 29 ++++++++++++++++++++ .../CHECKSUM.SHA512-FreeBSD-12.3-RC2-powerpc.asc | 29 ++++++++++++++++++++ .../CHECKSUM.SHA512-FreeBSD-12.3-RC2-sparc64.asc | 25 +++++++++++++++++ website/content/en/releases/12.3R/signatures.adoc | 8 +++--- website/content/en/where.adoc | 32 +++++++++++----------- website/data/en/news/news.toml | 5 ++++ 88 files changed, 962 insertions(+), 1037 deletions(-) diff --git a/shared/releases.adoc b/shared/releases.adoc index 4fd6112312..026a3e681c 100644 --- a/shared/releases.adoc +++ b/shared/releases.adoc @@ -43,7 +43,7 @@ :beta-testing: INCLUDE :betarel-current-major: 12 :betarel-current: 12.3 -:betarel-vers: RC1 +:betarel-vers: RC2 :u-betarel-schedule: https://www.FreeBSD.org/releases/{betarel-current}R/schedule/ // If we have a second release in the release cycle (e.g. 5.x and 6.y diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-amd64-vm.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-amd64-vm.asc deleted file mode 100644 index 2422aae61b..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-amd64-vm.asc +++ /dev/null @@ -1,23 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-amd64.qcow2.xz) = 924ca5158151f1631a5b8c5924f96c97b2886d43d5a1710c469ecccda7670b18 -SHA256 (FreeBSD-12.3-RC1-amd64.raw.xz) = bd56fdd1d762e935d5301be96342314d56a12c5617f027b0cdad6b3fe1a4f223 -SHA256 (FreeBSD-12.3-RC1-amd64.vhd.xz) = 960e0f5a274a3377e5f2834e0fea7e7abbba690a74f1bbe2c0345aa0b55ed546 -SHA256 (FreeBSD-12.3-RC1-amd64.vmdk.xz) = d5e1c21469fac05c69ff6b6abda28e710632e153ac6fd37154cba23ea25856b8 ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTcACgkQAxRYpUeP -4pP+Fw/9GS8JuJZ9QSJXl1rFuhC1XVKK/W49ZlNZT5o2evmLqC313OE7NPfoLcvb -hN5NCe6095JOc+8VoLxWhNDsLnPSeAuMl9983ur0tjNZ+/w79usYJXxRCjBBCKbk -QLT2wOS30bc0YWG5HR1oTDF2cafahiuE9LdBf5ZK8Ofzd2fbH+7dQ1ySmXDYQyQe -9fE7JH9mXxfeuIsMPj3G6xOGfb2qJd1bQk+olPQinXWLdu5kvS1APZGVBCArbg3e -qFCvG/IrJgUri9fOx3q9vGlEjd6/gkbFU29vZdGcpWYXzxa7iIewUsevEFlJ392i -5DaQm+ecXmtuz5kNJMIqYNwlSiy7yaQELijD0ZZoNW2SOLw63ez5ZqXFmKUDrQos -FLAMCoDnQl0O/pF3iYjxsh3E4iJj6lHaP9qlVIPfMwG9irG4LPt7g9joo1LyN/Bk -6VtNifgf3DxGGxLLfWXpmkqXllNp9zecF5a03lnPfzgLca+/GgZZTFh497rZ5rcL -iEzYZVCLfTspS2oVWYGgIUccp3/6ljiqFt3Hj4mVrXkpcv6c3dAY8erSU2HgMAMp -bo3htEvRVPsNP2zcVd69iTyAvPoaIzc8vIuP5OxLkeqkxrpEAsRJ6N1cuNGaxFh9 -xukAjx/lsCpsQycvR3A06KCJ1FrCi+B0niPT8UdQJ41a1HFH1k8= -=ZE5p ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-amd64.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-amd64.asc deleted file mode 100644 index ad54cfd7e5..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-amd64.asc +++ /dev/null @@ -1,29 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-amd64-bootonly.iso) = 27cb01b740ce83defe5de33b853d72a59aea34dea3c525dc14ca47cea3cae333 -SHA256 (FreeBSD-12.3-RC1-amd64-bootonly.iso.xz) = 0119cd62facb202989348970d400b155946720aae1c8cc8b1a4610060e37b155 -SHA256 (FreeBSD-12.3-RC1-amd64-disc1.iso) = f3b2679b3e05cf48a61a3c007af5e6ccdd291e7d2fa914cc75e6d5441c9b59a6 -SHA256 (FreeBSD-12.3-RC1-amd64-disc1.iso.xz) = 86e54c22ad158cf1c9de7636bc126883b3219ae7c087ee46f4dc6886c7fd0884 -SHA256 (FreeBSD-12.3-RC1-amd64-dvd1.iso) = 345f001971b2e0a0f5222aa3abdeae8c323afe90b486f6472fbbef1342820b82 -SHA256 (FreeBSD-12.3-RC1-amd64-dvd1.iso.xz) = 3c687f9eb24c4fb77595bc9d2fd590df45db4d8e3913eed98c19ed82bb75c102 -SHA256 (FreeBSD-12.3-RC1-amd64-memstick.img) = 8c2852152966a6b9c0d1b0189e01210acbc66a1bf85367f5ddfa37db86ba40cc -SHA256 (FreeBSD-12.3-RC1-amd64-memstick.img.xz) = 88af658a8c97568bce6d4c5410aca96d10d9807c669845719ee336eb41b83714 -SHA256 (FreeBSD-12.3-RC1-amd64-mini-memstick.img) = 4b3e93913300aa65fb12261ed5fdf15ab1253fb6a6b1f784549de04434d66a22 -SHA256 (FreeBSD-12.3-RC1-amd64-mini-memstick.img.xz) = 328ffc615a6d009b8849ffdf58039e2986f16fd29aadb02523f7df67e389f317 ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTcACgkQAxRYpUeP -4pPo1Q//as1gqLXtJRADc2ON43MSBncCFwbt2GcTXjrUZMQk3+d7KwSVuavEcUjG -9LTjQTiehwrI5/etlkYmWsdg0MgEUtk91eb5lsy1hyY+xY3h8SyYJEOnPcRuFheH -pjp95mRRr45zbV5kNnURzK6E8MviWn2y0u0/gB1UZjpnQvfEbyiEK9L3F/dN4SQz -ZfJPOYCNq26zgYIo2Cy+GOgbBjHaoJA6eop3u5lmEtFJanT3Ko41P6EMklblYo0B -8Xd08wzh11MPRN28r+j2OLAmBJy0T1d2lRdkxIkikGDvSqxeSEgfEevq5pGmNHOA -b9HGlhrg2qUiGqmTOh3e3KTng8xZuPt04RwrRa6ErKpsWzww7fWglw35DYFMlOsu -m7pmYa01E1T2BBO52/KbM4L9K1c7BYHqj5PhNt2HyqDMpamHC3C2R6ZJnmhw+joC -0FZDMhuCXhCZhelR9Y24ur4sn6M0yfGo2BI5oAAAWu4UAY4VMGsPlACotZig0B+l -nNGBvnXAmh/A5End/EG7FHeZWEptshf1li2xpwkpRQgTKxz0hgOm+nI5Md9QPJgP -kgIqkk+RdsPU0LM7fxNGr5XIFVWi4GXKxxbbl9ywBJwsXXLeB3TnlHrqFPqOPMUz -7yzjj2Kecq9XkO3Zn5B8qX1sunwa5KujUa017W5rLeDyq9a4WcY= -=2HYY ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv6-RPI-B.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv6-RPI-B.asc deleted file mode 100644 index d9c4e865a4..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv6-RPI-B.asc +++ /dev/null @@ -1,20 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-arm-armv6-RPI-B.img.xz) = adf2ce3701ca8f0467d7980920831bd957d757da5a136683f1d127e9bce8637d ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTcACgkQAxRYpUeP -4pP/9A//btbfLL4PBbDWvO0TYizTG6538FkCfetewRp6Bp0p8/QJohiathsC9p2+ -1/8tVwiEevnCsiel51+FTWTYdOpBzNJWQ3a8RIVvY3s38wC/t/xvPwkf65YCk8Yf -NPxB9s3DrzRXG6eaIuGyzWTssVjo1IrrMEVFl+x9qu6kCZAlmmJdH+mKQA7OOxlE -RNSDkSynqszvptvz6VjyLJm7uP8fnMRjOgWqLvpYUmV26/MVLA/5caICZABdEEbs -eVomkzfqBLW+/azLb1MRPooL6UIGFiTgtLWohsSr6WMTmIWVcEwQ9ehxVOQQo9Hf -6k4EjUUW7kFFuuXumOH/M3H8IKRMIPbkRtAxkwuqZtKNKdJRecqm6szYlm2mlbTB -G2P4Pp7tIFGVqqseYTFiBrrk+71/jJYSVqvOQ+oSpllGRo/r/ENLbD/2T0qqvR70 -S0zSWfFjVPxnzMa6kHtP08LaEFZ8kVN9F3TXeOtaUo2x9NP0lfzYK8JAiKMwrSV8 -QJj4B6T0xlBICiLkWHa9/F9sykJK/yJWIX7zg7+IBXY/BHKxqcKD7c2bIsIjTSWg -CJg89ogqdWZdnOnPveZgn7ZU3aBRhHHc/zyfoKSohlaD2+RWvmYE8nr6bt3rv2bJ -+bVjImZ59MqNag0PMWm+8ZOdqIYEOt3/ECKEBHRG5x+QfSsXdPI= -=2Qoc ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-BANANAPI.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-BANANAPI.asc deleted file mode 100644 index 416cd45c8a..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-BANANAPI.asc +++ /dev/null @@ -1,20 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-arm-armv7-BANANAPI.img.xz) = 35df0545d2b569ea611cfbc35636f2d1f49d05401911a8167980d64fdb9a7a19 ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTcACgkQAxRYpUeP -4pPGcA//c1d9+3SS3TJ6V/N7a7+y/go80FGKdyZtZk6mSkTzFjsWyXpPGnkBHTnL -8cfoQ7+RXs+uYCjsNdKotFEQueUlgbMaLg95EVIxNjiJscztzZ6KIA3PT1xXKytl -2ArJd/Y1ZaMt/6Na3POiCcHVWEWQWKXlIZ8YZrlEWEac2aWCKm9iJUHNr7dm9aHz -j2hejC5FWaXiPRlWnqWeXKu6noE+Xk1mWuTBZa+Y3B1mH9MesLu2rRc7gFDXbeXp -3CP+fWT4KaBcNPIfyxW9EhQPnwKiL0ieLbzVGf8MLQjTXsGEHa10kN4tULEDfNaP -z39/dnfWciI5t9NF7dX5O50eLQsiNAUn3Lj4m6J/kyX0UczpXKBAPFsHnHKzcrJ4 -7X7H3FAe9VjaQkNdwxD1Zr0+ZCbCEYKX6gWGU2/ZoLoVlVoxnpqLt5nuptFJYnlZ -YPqKAeIAQP1jCZHeI8y/+mhb7tXQ2CykUJWztsCy8wqq+bV10ivLdHn/FaLf1Nq7 -QgkVTw2jZr1/UXT8nq2bRYe8V1kt9HjdIy3HYnTWSCMf1+d7fCKwSeWNOiZEd8hO -L4gNeiqVNsuch/U9HHpG/mH8NNCseAdU282ifnwnmbJX9ISt/ifqy2zTSdZ5ERsQ -L5o+av2173xjZjINB1XSTxmofYOT35/y/lNt4Hpvl1oBpF5lH6I= -=7O9y ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-BEAGLEBONE.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-BEAGLEBONE.asc deleted file mode 100644 index 6071fb3090..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-BEAGLEBONE.asc +++ /dev/null @@ -1,20 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-arm-armv7-BEAGLEBONE.img.xz) = e69e6856920f602f2ed8afc2b57c822821cfb8e1b66eda41996291878997a9e4 ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTcACgkQAxRYpUeP -4pMjOQ/+Mu+1IJQSsis3MP633opX6s5uWASe+fAO/YOBB1CVumWV8UqRzz2LrZZf -2l091qTd107nhADzccVakZdixXEPVi02XF6gU+uPrwGqH53pcEpIbjJC1yVw+xMc -uSTo24aky6Q7QZWo8mJnraSP34Exd6I1saZiZ+sYsyVF4oEN53weyA6WfLNRjogO -2KjTTPwu1CU3p/XLgk6rddG8xKUzScKII1KaYYW1/ggRjnbrcb1exbMTHtnhXBy8 -KzwGsCPCXscczoJo0cCxA7Q2zsvXeo48Qn96FoH5Fn2QCVaD0nvPDMPuLPuBCew2 -2DSL5gUxLzKZFx6YgWF7VY2d8WdAmivs7akHwGw7hihaOJeCIr6Zw7ppZOjWE2eU -w/7DBAVlCS4Mdp4JN6tyoBHp8T+vkAFsNbtIUeYk1VEUJhhBpZiU0QcHw7MJlWyW -HvACcJFbt1AsEOg7EuBBSQNT83vdivXbNJ59x7sOLeVHCSme8yyB9yZhACVSJoVa -A3L0hWZ4o5EfnjQpDIGL56Ot+UAWv2PLP5jXcFzk7s+XfzMyNYMHAz+2721zZcZF -m5xxObyO34QvzQCViEJzQnbC8SgR3XVaJgEeKax7l0p6hR7ut5J39yOkj2s+7lcP -FjcIJWxnj6bW674CZxfaLL1Trl+ZE86iquMcDobAIfNY6JSDFpI= -=K+uL ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-CUBIEBOARD.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-CUBIEBOARD.asc deleted file mode 100644 index 345031c4b1..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-CUBIEBOARD.asc +++ /dev/null @@ -1,20 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-arm-armv7-CUBIEBOARD.img.xz) = 62f64b349188859cadd3971cd1532b0127c767288fceb33d6572b861a61f9caf ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTcACgkQAxRYpUeP -4pMiZQ//eBRRB4/Atv8ja9QYaLLKVXRseOLqRuM13Q8K2TcoCV6SwF/3/QuV17sF -S7Bh3J1GDa1us5AE9UQgbeQcO2d2HDPI7Cyb0F0p63FQvnalU5FZzCG/tWZxuY7R -SyxCAD8wcf4dTby4vOLy/2E3UvvikayyrJ009AjlZLtPFSlYG7nGg+p0nl1kkPlq -GoyM4Z8UHqJSlixxNhBoiMFMaPFM7FZldH74bKQgit39a3Xnpor9/IZ5XRMqFqBQ -ZkPKh/0yVZEuxtvvOholL7YX6v5J7OzO+BmAabATv3m9edafLZPpI4UzG556Ck8c -8kSg3rSBdCZprJ1o21gtISADvfabbj+rI+LuJlUtF2Dq5Nag08CD4EWDI0UKK8N7 -dChRs/Kqcw3CRoxPmOBc/910BqzZeqH8Pp1pruRTxOmAxpAijxeQh23KukCmU8cJ -coxfiX1a9AAKbRNpRVoj2n03Dmo/+sWbB3bpy0ydHPv4L18l96uGSwEp6rCF/XYF -QxRdSbYwj3FE0wO1yZjnnYEf94BEtArOKY6pGZcXkSqpTBcGrpkqdpu06q9xH9Kr -WJtXx50UB1txx0RPutw2TRfmVyuTjB8vXQZEgTutcu/lk48XOWQeRBkFMsPQqJbd -0Em65nJv79pSYMVuFMN8PVnymqfzOJ/5eAU2EptO0XyCiTOsBRM= -=KRd6 ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-CUBIEBOARD2.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-CUBIEBOARD2.asc deleted file mode 100644 index 5bf5d8e5dc..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-CUBIEBOARD2.asc +++ /dev/null @@ -1,20 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-arm-armv7-CUBIEBOARD2.img.xz) = 8a2925ee7c63ae6dd4df045bd292b44fc82f4f8b300127f1cb978768c894abf5 ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTcACgkQAxRYpUeP -4pN4lhAAlo7ElkbHrpT4bf51uc0Vur49zNxHEr9Pvosl6+I0omGdVu7BidKd90F8 -b5J+IJx7yKME0QEIkklmBDegTYQdwS0/tHn/Mr7OjOmRGkhuxnpU3RGYj6Ctqwn1 -SHLipEWw2VBjnD0AWwlEiwQNmfVyBVlTDTkR3COv4V693iPm9seuFhsYnA6t/SdD -a79f91NBHQ3Drgsm1LcAPuR2lBkAMmCqmtl4mopp+wd31jL7oWPkYlnY5scr9fBY -o185Tom32v7YOnEAl39AGGAesSn5L07zZ/cCKxMnfd8KIrM1/QYDFyXtGCq+jS7H -DFAq4LRxjx/jD7/hUr7VaZo6fDW5aAMYpxH5eohIJaFBfh6mPOArTtWb4rw5eQZb -o+vK0W0lCA4mz2fnOPW1wCidGQyOWOHCtc3PbzgyQemZJzDBaFU+/U8CpzHoKP0H -LzPj1HNxV7OmZwPI6QNb+zr95MqF/BHbG9bUIaiWJWBuel6ghf+mJfqamyHTFD1/ -qvp4TS9UlqL4q/8p8GaLuK0QTFgFBNFUR/EfckJCCgrKa29vbeuUR8tKkbEOz/vk -WhKT0HAMO1uH4bhKEKXHuDsV83l8j6QtSUv3T+VMvVsmzYfDI2L4PH4PpFmpL1U9 -GsI2yFT97gmJMBvkGEjaNQOkNLYY2gt3cF/QKIIve8kUwfuXCrE= -=Ym1+ ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-CUBOX-HUMMINGBOARD.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-CUBOX-HUMMINGBOARD.asc deleted file mode 100644 index 049f01aa63..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-CUBOX-HUMMINGBOARD.asc +++ /dev/null @@ -1,20 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-arm-armv7-CUBOX-HUMMINGBOARD.img.xz) = 33b8283d577b05c651a580983b7c943a4b30888f8a3787514c96aa87ea0c81c2 ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTcACgkQAxRYpUeP -4pM7jQ//XGB973obUjf6NvHw57rRvTnGHL1GLJHLLX3K024WrueUAyXFQeX8ZWWR -8eOwChOEg5SpTmrLe4Mh0rN/rBs7s52w6X+JZl752L9fgDt+vlA/G2pdNmYSqK0F -4VR5tZDiSLfzeL5LUCRx0z2MlR2a/o5WKjKM5TX6P80KnXudiTo2KgLPaxbjXWTZ -3uFMeN4dGQMF6LHJMHzaHjRLy4Uz9roj4K3NZzk+TccrJ7QnfvrObkQA2wapJ9tv -S2uhk6BkyaElXOJ2XL+cxsOx2qETAWNRJZTIycWZ9TsJTN8/7FMQetzQnLCLaeSi -D7HrFUoZut2++2HUSKyMEueGbac7RB5PPkJumT710Sf8cG8U9zetveIi6Cdfgq0Z -8K6gSVdWqX+D4JLglUo/kvj6D7eHKKpv+20WC8I43jfu9n5dgEilcpnyk57m2IPe -+WHS9wm+7m2M7jlPaxgV1FT7rezCtwIRTdqz056eBUsXr6cvhrkjBEJSGP7LfR32 -JOuRksO5412jlDwsbv2SGud0edPOOWL6gETBej5XXV31gpKa40u5aZ6BMnwIfbjG -um7vtI1769UTUBNvv62ID26GmZ++dnjXW4s6OQxILBIxrJuAHgp4CO60AXmWfRtw -L4GHbWT4zdf4e41VTjdm0xSljMCOru7lvjhqwKZLoklUNyV0Ocs= -=eHAt ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-GENERICSD.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-GENERICSD.asc deleted file mode 100644 index c8d0c06785..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-GENERICSD.asc +++ /dev/null @@ -1,20 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-arm-armv7-GENERICSD.img.xz) = 1358080df2cf8d362dad438cd264a79d0d97f8fbf2d01eeb1ee41ddd39ee16ce ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTcACgkQAxRYpUeP -4pNCBA//ZkmTDS2e37+gfAm5B/+PgwXkefwBsZJqlFck4uzFRfyATBM5oHsGZpM7 -4z4fqB6qWniymmwiRhX3Cv6cOs9TJxxdr2TVYeT8mVIz6ombuDnOqNGg/6PC4h/d -6idXo5GhodqWg2yduyA/4CEIjEnHT3kcuzwNEVNnM2zAzTo8HGv5CBCx0tJWLWXK -4ZNZTl368H+zz6YDlFHjQRzoOcwHHC8n/0vny45XWlKdZgBjBuq6MtrJUb4SdK8k -auAjh75IXqhEZGA4IiF2OJpnL5Yl2J2UJMQ2Ip4m/KH84Hkodbb/3U+OC0HNF1AS -mlJmuZvX3rY/9kyQHWcWIgyOsXAJlTAxMTbaicJVEUeKZmgSH3AHhO9AX6vKBgyL -8Wac1yRfoz0GwHXrVCMqwX6zrFg+rM5FZLgT4rCHz2WdUoDdiyxYD/Fhmmzy3Kwb -0HfdDt6z/WjfFz6s6b9O3s+S5LexMocMFPgspcbDPlmRKboCQlRmAv1dWnzuc73g -01edvoBHcWCP2fzp5GEjm90qkCdlV6WBzvglzjz1m3Y/pbPruv5ZSKaPJFxEgOzP -czyet7TB+MZVkvZXYrzP8R2sRDVZbi9V8AtNku2Q6F+zd16N8VqFy5v43eWyGoCu -V6OiaX2vtDyxlT9cNtQJ03ozAyXaO82CyOFUjKhqIK8MVC2+mOA= -=AiZk ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-RPI2.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-RPI2.asc deleted file mode 100644 index 5f57da174e..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-RPI2.asc +++ /dev/null @@ -1,20 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-arm-armv7-RPI2.img.xz) = d44cc4372ed79e41189e01fb14026849c4f05c346c07537918422dde05212f43 ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTcACgkQAxRYpUeP -4pP19A/+ICyh1kbb3KfWNeXJyWlc3dhv3Sr63T9NXKpMG5wADvuNL200kvNaQ/zQ -vP+mcDWjSXL6ujDRLeZxpMFu3ZgSGuHV1ZLLa+tEaiZ2NiKprnsEjRiqAYc8uJOp -6wwfGpVY4BVJMg8klkWPK6CCbe9hMd0wVOqdETx+BzM9gtOGXEBmIe5WgnoBzY4l -CdxbELUUhf/erb/NAkfll95+mgUu3GCbUSQnZB5ymCuIPsi2IJEHENg49BBzFES0 -J7Y5L6CNXuzYJDtxUcG+Qav3YeKWLUpWliZGqUPnBTVXKZU8bY4OYtU2EmPLYV04 -gWDH21pdU49sY/MsctZbLLXSo+qV/PhRrsCvT5MqYAcB9NK0lxw2689oSvvCLhbu -l7fAvwpceIWyBfbz3l3kbmGggC9PyNYX5w+hWSL3KzV1aBT4twgHuN4idFJnkhd7 -bI1fXVnkUjP2xMh0rSOzcmOeBEdqGHV3HH74+i10PaIbcMUZ6j6bZwkHRiluEZEr -t1r7iATZ1xwbtSz5AN9sOcs8Gq1596Dw7JWfksLxyjkkRDGlo4y4hXeTAdnrjg11 -HuJCqycgs5rx0Eyzgl8Jd/iDg4kTMgSaWPN/MGkBDDZu6WoE8A8OQmHsAuAE3VQd -HONBYQ3DN1niS6soYy5N3jPws2RpMBkbRrqyRrOpPC9IRj8cLIA= -=kbfx ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-WANDBOARD.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-WANDBOARD.asc deleted file mode 100644 index b5cae5b781..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm-armv7-WANDBOARD.asc +++ /dev/null @@ -1,20 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-arm-armv7-WANDBOARD.img.xz) = 46183b86138be654ac1cab19f42409e26ff5547190bedf1b37f21351c5e490d8 ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTcACgkQAxRYpUeP -4pOeIw//eqlvBx59wZ7dwlzbzX5DiVqW1OkmsyO+q/q5wiu3XFshPxh5QeAEIcqJ -vR3Umm6gHHLxwoJBdF7zviBlLuPr9cKBwjnamZWS/WX7iSXR5Ix9T2YbmFOiA+xh -cTr+xHxB+j1RVnIg6vfBGTnLPERKNi4zfsH/aWrBE3ZASWi9tfTkP6wpWa8IdV3s -vGk07OZBzTtEpzh9+U6iF6kNvXSrsbi6DuFbVqXHHf5cRnHtB376y2cSRRyR6mW7 -b91uSLJWqmlSlnxFTGZlqhH8ijBoCtIKDad+9HeCnQ8BpaR/n8H/fUxk5bx2uxg9 -1SUk1nVCRzKMHOVF7BotzZae5nHJWRRbedzdvAdUDx34eStkfP8hc4aJMzdBlwKU -0mLiHQ9hJ6J8RDxJWH5cWxAaS2xVSMiwLP0hzCktqF8rPcNAumIittRI23G2/gNF -U+O+5piW96ajrCnXVYIl8tR4YLiZeB4ZuApmUMoiNJnsEUIqTd/K5Yh1sMKWWRFO -6A0vmFrnmiNMDNlptzeu1r8N7B8HCSLw8QuHHP0+LNHIo+Bg6CxiiZM/zLsLOGDl -IT/cr8FssHS0C6RpHLbkdLIUR2dzkYd+blLOv2VK5AiPoH6F/IVwKTtgytVAF+j8 -n7SK1MZdDTT2+pM/SL0hTF9/rvPB0YN9y3lN9igrIaX4SJpH9c8= -=k6Aq ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64-PINE64-LTS.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64-PINE64-LTS.asc deleted file mode 100644 index d7b504effa..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64-PINE64-LTS.asc +++ /dev/null @@ -1,20 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64-PINE64-LTS.img.xz) = b2e8743d0626bca7a353f181cf7b10bbd472711faabf114dfffd1af6800aa6c8 ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTcACgkQAxRYpUeP -4pODWw//dsb2MbvnA/YAB7Oz0hvMth4J9cZGdvsbktGB/VvwUDf1lvqYIhPkcklX -SEyYf3CjgA4whbjCaa3PaT5bjSK7hucV+dxSrme5yr5KWsUjDRQX2+sPe0CFaQdO -+g7K7xXrHjkDbjqvJltuwEO6YPyX/+JFM7/VGQogJMbdkfLF2jwyYm1i/nBSSZ1i -6VpgMYp0WVbf6Int+F4n/VaeEAqGQy2m3vgsJPKj8KMWodb1dVNriJwDfVBBTdkP -0BxS7G/52fL53aXY87rDwgbY7lgp57074Bj42ojaY4wOoR5LzQabLJGZGhqz0np/ -dBaoK6TBjgMc9sCFID+YNnaNnU+s+U5Treka73eHtI/7yEnWUW9R7YgBNaiVCVER -ErqswWwh177g9z0pMfkt5uiD8pJjtgZMlOwWOYxEkXTsK2awB0K5ptW4LKnvxNkO -7w2az6gO33QoeTQuhT3cHrDcUMevRj6KZGfdTwL8JrsDTXNNSsjboKbsoXiImbU7 -W79uvjZmUipHTCoJqCu5hx7F6P+TfFFTaH0LsiXdQdsx375CwwjtnOnEkxpsms+M -TS5ef097r8pY5pfF08A2987m2ORjoFGNJGxvyOz2Wai5gGhb8dbjBDcZo6ETo1FO -6ae3WEoe55+RlEoOG/CF31pUkH4d7mQDFJvoMsToYTmgM6MLAPc= -=1RpP ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64-PINE64.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64-PINE64.asc deleted file mode 100644 index a05a3aa35d..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64-PINE64.asc +++ /dev/null @@ -1,20 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64-PINE64.img.xz) = b8d82f0b89114f80d75d0f112a42c2db2f5e549157e2e95e76931bc131e1298d ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTcACgkQAxRYpUeP -4pOt1xAAg1Ww0T+zkBRXZ8dYvROxLmJnURiG43n8odc/76Ws531Lamh1fk+ztwMd -8vTJzA2Aove9oxEH36SlgajrxZUpNZkNwNC7yQ0u+Bpxv2Ye+I0Z9muLXrRRLQdi -SUiSmPpUvhNXUHGKqDJ9trNR2xofZ8zEelnl9DQUQsEy7ZkLHFDIHYKsPqwdyOdb -HthtkhyQMoy+Ky5prQj5+rckFRvQziQRIS/wXI8Gto6wTpcg0Mb3xYhXZK9RzwG0 -VGtJVZ4wYlbOSmumaCu2wHMj6NKTEwp0DCSUdoAdxzvSmw3BbKWN8M1BRRyhtLrP -DYsWF15cOKjPTGp71geKgkxdEoi9Qdo9Lw7rJIJTGiK5S5v+KJ7WSt9LbiFzlL2A -GPEtHu4x6SSXeOny62Tb91qlldlwCLhFwFk0Snbrbq5qOhAGiSftO8mUxETl7Qpr -bTS8Ho9TXdz3zEpzntO19adI/jobb7vgni5PDwXgtnH746M0d1UuNFrWoNQTozrb -B7IcpqORcE+puKRylTw9tmd0wBNj29gcpz4EuCa9sFN3Q0l8W8Z7NgKlRDN7bPEc -sToo7dh77mEcPwVHHwk5aRv8puVjNg0FKYp9VFNgRhbOSsuKXJMtZ7FcksJU91D+ -MTbpX3zoTR+4/nq0GZwFvTOIbMbqzqZrex1lJqSj2NSHbSClplE= -=zdAZ ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64-RPI3.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64-RPI3.asc deleted file mode 100644 index d32ec967fd..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64-RPI3.asc +++ /dev/null @@ -1,20 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64-RPI3.img.xz) = ee40914932a9c27074df494b10a461f0f64f96ab2b7dcfb0990856bce957669b ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTgACgkQAxRYpUeP -4pOjqw/7BVrtijeZ+hnRFMFOLB9ysNWDMZr1dSG7SGtIPs6He/C7RcpPJwP4FV8E -/2cLRJj/I+FA7XLbrIaYFaTMfD73ZStqEoFm5DQe0Sg6y7NduKmcLTYy/zNLNFUI -nbo+lQw8w6iSl36qTNy+VVso7J4bj8ennOkUxC4a7GdjchYzMzQH3mAHAw7vuXhL -/rh6xHQlBbULkOWhpJZmLc+H37yyryYF5XbkeSaNomiXSx0kB4yOYgBUMQjoGhBX -VGxVMUwlV8ups5whNI3v1nCciXeOfhhGYMFcZjSFvOTwsPlL/RRE4cXo63KfFa0L -l1Un8pZVjZTtnfDDjQvoyonHde4KQqitcAosaJYpeTeTX8X1Lk8WL5nTgaPwyDjV -5l76k6JVcrAKtarD+gJd5yE30SQ8DTmyEeJbDM6ZGEUU3KgDpFQ74xlBa+BZym9s -UJQZU/iQUIh9JUFn9wTu5gjaD71YJIDV63KgrRKPdp1vRmNMUYW9l0hN61zWiB8I -IVNKBrytzVAmpXgBk7hrwmxQbargF1qozUhOaFM4JqMXRmau9IQ3ErM+DVYZKM3r -bx1wEliWMObROwXpTWdX0CSfRwsAFDD1m07y1C2ZA5t67XShDlkWfwdE2mFPXmXD -8ZmPA+lKpipmmw2rmxGJe1vN5jnELNlAsl814ABZJAjySU9gK1w= -=m1ab ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64-vm.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64-vm.asc deleted file mode 100644 index acfe0593dd..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64-vm.asc +++ /dev/null @@ -1,23 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64.qcow2.xz) = 351289cd491eb82081e88ae3e1432dbba11b33874426a03c4c0594fc0c9f3261 -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64.raw.xz) = dec0bb2c7483727d3cec4b624e72b7c02fbda7050f8e1f92ec4524a8c84f5357 -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64.vhd.xz) = 2a768d7ac200cf273273abbedc0d22f096d5f0507ef36eb58b6014c817e95457 -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64.vmdk.xz) = 750876f30b844e8ec7dff8f4737a6c4db22983d1a2122e963a615d3184fe51d5 ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTgACgkQAxRYpUeP -4pNGwA//WAVvfEstbkM6gvChkTfwbLlalboNwR64jtwM1s3AtfmujxpKQBhQ/j18 -ohdTgP+qd7wX2lZqi63MaAHSkzlMfcaE2oJduvWHNj/lqMClXLDlnv91OcdPa8fa -aX6iZ8nKIw7B/M0wT9T34babV+KtXPMPpkwa8Yce6JVrGVKlFQQgVxd2ZsIyGSaS -eRU8l5enfQsP18+RAcF9vJTDwaqulzL8qrdY7t+utCQeMAeRP0EqU3M1PbDZA/FJ -NEQDyi+ofigou7T08aBcT6Rf8ROmLkMB6ino5hdzJkhWjiNPF/v1RANVFa0Y9sxI -gkNNhrgGsxGV5LaXz+8BXdeYr82lf7nUc9Rc7cF5hgd9p8nfV9KxsGb8f9jFKGr5 -qtTw7Gnrhr+V6lICMYz8M8ButLttghDfEj91AQKS5aRB4bpn577F8mOPzL4uNv9Q -Xzq3iXUyRDb8JlaahTHBA+TX9CM/eHNd5tlEwcLIRrnV5jy3tzoADhe8bIPqg6oI -oAN6xepYKZFnQslV53w0RySny+lNXXDtV7DiUUXGhdwqmtyQhryCRfvbcXHMrK2X -AiXB5OkiOBXaSE8Iodh62gbGZkJivke7xSJJasaFDvM2R56bu4Mi19JZEBi8oHAs -8tsDc02xzl791nhMTraS04lGqMqXMCctlqg9DcqAG9boMgj8goc= -=osw7 ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64.asc deleted file mode 100644 index a7d518d0a7..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-arm64-aarch64.asc +++ /dev/null @@ -1,29 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64-bootonly.iso) = db9e3d502067bfed279cf8fd2ee3813828bfaba8d553d73b0545ace7fdf4d5b8 -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64-bootonly.iso.xz) = 9fff50f3b65ac151a1aaa5420525c0ff12abea59509a1cd58a8b2ed3a0f6e2c9 -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64-disc1.iso) = cb5f9ec376d0535d3d87e5cd67e25adeb215df2a0d8dc169841542d037c49b9b -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64-disc1.iso.xz) = c8f04788442c4b6391ca2c6d64b7efe4ef3b4cf43eb1516506806202cd519f3a -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64-dvd1.iso) = 6a2125f51af3f6a02a5fbbdd645788df969a7a32762b8d067dcf2a367017a088 -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64-dvd1.iso.xz) = a6f293f196df5edd8a7121e5569e168e29080ea810ded71d6556a9374dbeb694 -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64-memstick.img) = 38bbdf7f7dad4784e507ce62d91b8292c62bc8f1227d4ceec7968552e3e882da -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64-memstick.img.xz) = d89f468e93bd8f113e04da12b09972c891426e4d182fd7f5507e429884311a00 -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64-mini-memstick.img) = 59d828358e2bd2c9c6a0cb6df974fc3375a263fbb66ceb15d1b7982e21cec5e1 -SHA256 (FreeBSD-12.3-RC1-arm64-aarch64-mini-memstick.img.xz) = acc572846550054ca2c2c11eed22adc9ab18076a5735ba8beca02e437c1ce456 ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTcACgkQAxRYpUeP -4pO1nQ/+LD6dvcix/1Jz4PL3Tiox7QM54tWiWASWnwZ57dBx3C7eu9GsDFHdQvUs -2PJXz1dckTf01fE7aMPxbk1LNZy81VXwTBGIq2YWLjC7yS2XXIlpLqJIZkQRZ2jf -5iV/2isu0gLFjSAd84p4QAjT6vqgGKJV6GFMlvpvubF2lgF/Vss/kCfK9Fac8m3J -WtjCNoXEKwVz5uUOKS1CmHxzBOdjDE1lJrP2UHFL5ZfstVoRy44/kaGdbwP8aio7 -AVaPZFCw1y9CZX7DWlW07mnV8vp9dOrfPMRwuIkJZ+B77gDxk/IwaCZeYHFzMpIN -t04FjrmeywbOAJpqHPPi87DCGHE5vO1vB+Ry2gHsyIK7/TX+yo4GjVVmc0vgdirm -2WjTw/ym7D2/DqZCXigOsjfAeDKF+6CYAcKhK3So6CEJaw4HIjTDEUpOKZw1vPR7 -0sRHTDHaaEUCbiaxV7PpEym9fYTeNqEauJ3XrBMin85KGvm9nrfNwl3pye20tQUR -GQIXQMDIfjpFUKcW26q0B6JwrM+qnbEB2DTn42JkyEYXHDrSPyF/1eg1IntLDo9u -8X+GhAgrGeixDEq2SjSbWSJp+XMK1tmJz1oEr2PNf7Q/lNVN+6BaIr7/DPwt9TDD -7uu2eo/BHjFnuCsHrmMUfz+XjAXOnQnezJeDt9Uzmv7yEEKpiFY= -=fX1m ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-i386-vm.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-i386-vm.asc deleted file mode 100644 index 7a0a527c73..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-i386-vm.asc +++ /dev/null @@ -1,23 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-i386.qcow2.xz) = 7a675f036f8362a1cb2b121b317f41260c851444fd71e8152be7ced372edaba0 -SHA256 (FreeBSD-12.3-RC1-i386.raw.xz) = f961c08d8f1e36a9be20f645f9b33e752c1ab85dbbd3d4fdfd4cca6c85b6d476 -SHA256 (FreeBSD-12.3-RC1-i386.vhd.xz) = 9076a7c230c8174ac45b61c220fdcb7b79d6bb181395a304bd910d849d2d3f79 -SHA256 (FreeBSD-12.3-RC1-i386.vmdk.xz) = 7ccc0d568e1c438468156a2394041caf97403674a48aba3918f11d9a48571010 ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTgACgkQAxRYpUeP -4pO+QxAAhlOi17VDCkOn6ezx/zyonJ4kg9OGvGPLDYGArr8tgp7HcymAtrmklQBO -T/QiZDZmHFLjULU6ptW9e8wX6vAe2OreQf2spms6xrEtXqJjnI67eu6rEZVS20g8 -N7XZ2JUy4oTIymrAMTV/bQVJVjqRh1CnO4OjAxVN5VxbSgFcZSepT0ve7aY7hovO -nVjHIKqq1iAqmk/URVwSKlyi2jjnXn4zV1eKtMXzUQEvq/fzkfwGCx7otcVkY2zZ -rTayY2kx/huRItMtmIid/1D8j39IEbGbi9GIfD3ImUOuPM5n0voE9tQHba69NG0c -1qXk0z+3RDE7p1HfN/CwQHUL66GkKZX7w40H255u0rLkzFiOfAM3+vGD666WnOia -7MkeeH1vFNIYMMIvUeQd71C3pmZUHPqw8jwA3d98CJiTmut+Iu925w3KwO96hrgz -1FErVPvrL5wBBuIk22GrMnosPE0dOwK8AjSB5eOhvF2DTYpnElP0aBRiM1Apn8iZ -jIDhIeeqrER1eBPS4zWS4gp8zUSAZFkmZS0jA4GZVmL9S6efp+IgUG4+RQ2kwcMS -IFaxBgRt9wVht1OwIfV+1ZC3XyXif0GWYlv0eE2Q+HmT5q/KvLaT0VMgL43ThZwb -u7ienaHRp0W0GKOjysoAvRFPsYEcHiEi1cWtQfgQm5/msgP5XDA= -=sJVh ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-i386.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-i386.asc deleted file mode 100644 index 5a6f18af23..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-i386.asc +++ /dev/null @@ -1,29 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-i386-bootonly.iso) = 4c5f718d602a24c3165529ec633e75771c50334b9caf0b048ae1be53e10a383d -SHA256 (FreeBSD-12.3-RC1-i386-bootonly.iso.xz) = 7b638e94e028290b20795ccf6ad7b2d44e0f8d8821443180cc329e92187d740e -SHA256 (FreeBSD-12.3-RC1-i386-disc1.iso) = 1500c64b70b31545250e832a53b26ba7d28db6b8acc6a1d1fc31b4fd9f881666 -SHA256 (FreeBSD-12.3-RC1-i386-disc1.iso.xz) = f3d99e6497f4bd318dca4610d623a34fb1ae8121161135dd3a06dc2a08ab5e12 -SHA256 (FreeBSD-12.3-RC1-i386-dvd1.iso) = 260adc173609311e823f6139f4e8732b65a3c8be1a81cdaf909b48b17e4e7241 -SHA256 (FreeBSD-12.3-RC1-i386-dvd1.iso.xz) = 0ea401f8b6abd98c39f72b14fa7eb778bee54fb56479d9bd12ea84ebb4cddc5a -SHA256 (FreeBSD-12.3-RC1-i386-memstick.img) = 63224afdb4d9dca895d4cb083766aae986a622e3e932e8685c06b3c198db01f0 -SHA256 (FreeBSD-12.3-RC1-i386-memstick.img.xz) = 798cec440996c41ddcc289eb7835c26cb2888aa92908826910868bb876c3664f -SHA256 (FreeBSD-12.3-RC1-i386-mini-memstick.img) = da4013604758c4e77795e694b80d88a2ea779e07779d27f53367c4c3d09aed7b -SHA256 (FreeBSD-12.3-RC1-i386-mini-memstick.img.xz) = 68ac082f7fcaf8235ad0abebde378788600183f39e9fb30b8853e2840fef106a ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTgACgkQAxRYpUeP -4pOwFg//WCS01VPluToaktNs8j4tNLkO5vKPlCgChby4YfQkcYtPoutUCiLnZAQu -U5Rrm6pxO62hAulCXEdILSU6kYATomIC+BCSTXDi+DCfH+fxNeiV1/kEAx92emRG -tu+e9SgHhGsSNlS1hZ3JN+tQX/j5vPkmyFvQdEwHzq0QHSXzs+1T1tsZH7Nhm7Uy -10gZh6q+iOTzioBCZT4w6XNtELdU8Ex3A8gFChh38XsPasAo74AJ9U4Os0LuGRxl -0P0z6ty1bwGZfoeX0DiMVlGwLnHiBJ8r7EdCPthkijT9QslxxQzmQXYbbsxKt53N -/CpuFlx2MB8mjlJrJK0+CneiTX3AOM/S5p7onl1pQ9rA2WQ0IZUf2rfTlrJZytdk -+UJEC1dpwjJ6yXO6taAdqHVqf2P9j0cKZHTHxV5rPlQGnVEhH7AtJjaNEraQOr9k -Va+EfEVsZc5SLTygtGbu49XCpaBjQbFcIV0B+tSgaTCS5Ca06PXgyB0lPGBx5z7I -XvPcPGRrX2/OyD5dAZe+jnfY563isr12OhHAw7Lo9wmI3Cfs2s04qePhsTwRQ6KA -9t0vhwzMUcDQGpXBvkX5v2TFMBjhWrS+tF+871w/DSnrT1jHJ31WeTM2jY/BKwO9 -mI8VkprG/3NdBQDIysKDpE0nohkM4Zm35b6x7HpoMNzN2T6Q4eE= -=DbDZ ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-powerpc-powerpc64.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-powerpc-powerpc64.asc deleted file mode 100644 index 8384ff931d..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-powerpc-powerpc64.asc +++ /dev/null @@ -1,29 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpc64-bootonly.iso) = 86a5165e44e54dd25c81a9e6c2634d3d5b99612c447c99cee57579d25c5d38f7 -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpc64-bootonly.iso.xz) = 325cee9d774bbf93d81bc708e89f9f515ce62e337171b46a04c9b22d87e75682 -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpc64-disc1.iso) = 1288bc55de7eb6428d6b421c7fd02dd23ebea674d9c8ac855c7bda7c14ac9a0c -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpc64-disc1.iso.xz) = 92a98caed658d2e34ed06b29a0e52afd1acd4011b9e62f1e6af8a17a779de395 -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpc64-dvd1.iso) = 687ef2a21c271ffc36a2b475bbc4ad6f8d41cb4abdc03e7b6cb18f96d3c15d8f -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpc64-dvd1.iso.xz) = 3d69f4d9a86215f28eec9b010759fd52288053355a2bf40a8480d44fa04b8cb4 -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpc64-memstick.img) = 7afa543883cc2129c6b7ab8a58f5c7cdefa19ce6125f4904f313598e9d8c9a9e -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpc64-memstick.img.xz) = ab9e5226839df8424f688128b624d3d8dee4b0b4e247b6dc9fffc330961d6791 -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpc64-mini-memstick.img) = 80bb7daa681f9c20d3b6958796389c295b831ed8391a12927298b0ea12a62376 -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpc64-mini-memstick.img.xz) = fdc8df47744991ece051c9b62e4598ff1304e03f650446f823e4845a2708f87b ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTgACgkQAxRYpUeP -4pPEVQ/+PM/OjiCUfD6A2N+3UeE/lzNqXykNfZNk8ddQhMUbbNXcMoygeZG8HENt -ZI+gAa22I6+Y0ZmLY3+HXU6jTGimJ6yrei6mUxu8Y0SwF5mAmQTASaf5ZsDH2JaF -Qmd9FGgnFn+p+CQFteJEiJrm0mwHSXMOF+F4FMlRnPzn8JxAUFdIQARrZRaa4nEc -0qC/WgxgczFauXdx56TAh7gMZgG69VyePYh8XC30leUvLpadyyDMb1NFfFbfAW// -c2ru3/aCqyrlvznqVGCZVW++Clg7kwN0ERgVHNfGU9iXgGvzrb4FfQgdQIL2tRN+ -+wQw1uZyutVR1HfHLhBIi307okJaCxANO4g6Lux02gkmr31FIdHjHhM8MQ/XGeN6 -gMW268sEPOIZo92RDdbUjKEYSIvbNuaP3/uUw/y1dP3HHHejWvpVP66iv+7ZGIqe -7m1m8KuWnkQsY2QhMN2J/VZlqZiqkzKbGwT0ph+yeXjYAvHwzGRUlWax8Z8wI8ZZ -1tmh4PuA9b8Azx56IC/OseEtpDxp+zcqdE9w4vTue/HSUkWn0UBM8iiEdOngzleJ -x51hYMcbrrwtxNSKPLGbSP8VLJeOjC2qhN/dpz/C1jexP0bCmGntU2bZY5vKD6qm -9Pf31HwVDM9TCQo7LlkftG//TLOyquVsFDOpCqVlcGzwp3ubn40= -=Uc63 ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-powerpc-powerpcspe.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-powerpc-powerpcspe.asc deleted file mode 100644 index 52464b4d55..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-powerpc-powerpcspe.asc +++ /dev/null @@ -1,29 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpcspe-bootonly.iso) = 40fd76becbf65e89fc14f799fc2fc3d0273b97ed05c4feb1c0620d4808f863ec -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpcspe-bootonly.iso.xz) = 765db498f295ae3a233a3e35829ee0ebd86d71dcfadb57662c7a1d7a4fecdc10 -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpcspe-disc1.iso) = dad0ddc9f5e3ec763d9298bc8b25a57ec294c1be48e3ce7e9a415c67dbd59065 -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpcspe-disc1.iso.xz) = 048e84b6c87c80568011d691c935ced7253d1b726561733ba89f93f893fa0952 -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpcspe-dvd1.iso) = 3041a741b0db4f4578fc5a97165e1630db2a76dea60041753cf75991b2cd75f8 -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpcspe-dvd1.iso.xz) = 5178aead0fd98bef665ae436435449b5bc2305be8a97af93b8eb6314d0265750 -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpcspe-memstick.img) = 9aaf7bef431be2457e14b128f8e9ef651b7c07d6ed52592f4d56f94997ded50c -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpcspe-memstick.img.xz) = c4a7249296dae4c693a0851176b8cef8b77ddef90f31c31b587799d335ad62fc -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpcspe-mini-memstick.img) = c8a3d6b16f9b096ec1677b6c8f84b0c21d26e9505522ac891edb4de9e90709c2 -SHA256 (FreeBSD-12.3-RC1-powerpc-powerpcspe-mini-memstick.img.xz) = ef791bc476378bfb21fa424f4729fb98685ca3ada99bb5e6bbefbc7f9ac9f7a7 ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTgACgkQAxRYpUeP -4pPqIQ//cjd77YWBjcYytXXRpi6wbVEqNDuzX5V7gnx/bvOno9KVQdYAiqShBYxo -znSw2yKtcpi+cR01XZYWIkF/o7eLdLwSDq8h2RlyLs33fp2U6PqKjfXvh50KGCQa -6k67qEreq1NEd64dQl0tOdXjjSKhDWONfTsmpAdQS6/p1vPiBxDFiGcqyMjY/+Tc -DNbTHTvC4LaPNwcaGgMvDpN5b6SJQOMp0O1Km/HR0rWfBI8kY/0/wGzOyHYwz4uk -PCu46xG0mSN+JRwYnNhtMir72kA2Uv+J4bWXa5CpksYUDQ3bXGFj41h2Bu8nDmjg -sQ7g7haa0cX/bLfI8d1MF5Hu+Mob03H5lI1N7qr2+1MqaVs2Hi8uhtOvCYkGsSKg -HTvuyz3OErrH17FtsJEYmbiMnsNFNf6SSlNeyvm1i4lHWu53UQmxG0XEfiZb2MSf -uWFUda/iQjFPVH5/pUkjktmR1JRdCba+/0tsX9ZpdDMxp+leYdTuyzRpD/Vqr2FA -1kyqakqqu7PCqwZfRPHtOvio5m6bCil5CM6b3gr1RGqnOzMVoUlvk/UDaCSTheYV -ZlaCph9AgRsi0iVrFeBaGP2265cHADsvwvyV7Rsemv9jpk1g1cZ26p6oR5drkzEn -O/x6EVh8V0N0D9F9O9E+5W1XdJvbzBdpPBZKgFGFSqmYO6JXDkg= -=NS12 ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-powerpc.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-powerpc.asc deleted file mode 100644 index 5625ab13e9..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-powerpc.asc +++ /dev/null @@ -1,29 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-powerpc-bootonly.iso) = 84ba3eed80153fb456b75b3a6f3eb9d4e82376dea8ce21fd932529d4f94c277d -SHA256 (FreeBSD-12.3-RC1-powerpc-bootonly.iso.xz) = 94450460e949cde8643bdbdb1bd66a60f4c8af09f0472f4a9dfbed4f2f05762c -SHA256 (FreeBSD-12.3-RC1-powerpc-disc1.iso) = b3f1b3985d3d21153c4316e2c0abcac0f19d7d3731ac996f9c61121205914ec5 -SHA256 (FreeBSD-12.3-RC1-powerpc-disc1.iso.xz) = bf97b528ccf97c96c47fb3d09a5770601a7d97e3673cfeb84978a57d7e7e257f -SHA256 (FreeBSD-12.3-RC1-powerpc-dvd1.iso) = f88acece4e976af0ffea7f0183c5e69742bb4dc817afc4c58204c2cc733251b7 -SHA256 (FreeBSD-12.3-RC1-powerpc-dvd1.iso.xz) = 41488b4534e88da318a55109ac46442386c82a849e03b194318a9044dc259c1d -SHA256 (FreeBSD-12.3-RC1-powerpc-memstick.img) = 5be64164b2197ac47e35814778982daf1ba8d498b013d9a2044d788e63a3c166 -SHA256 (FreeBSD-12.3-RC1-powerpc-memstick.img.xz) = d05bb9ad89520e674d7ae462c1917b2145018ec76b7b2423a01feeb2abb9a816 -SHA256 (FreeBSD-12.3-RC1-powerpc-mini-memstick.img) = 1e5d32311722f0a0739a740e98d319c1fb114530bf6300b15311c37ea8f11b44 -SHA256 (FreeBSD-12.3-RC1-powerpc-mini-memstick.img.xz) = c594b764123ee4069df61fef207a97a778d77a9c3ebc77b7e967445a914acfff ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTgACgkQAxRYpUeP -4pPK2Q//bfhM4prFlV5n/Wf3uUT2uIluo+Dy5kEJ3W8p88Swb3gbKyI56VFbTOeR -nVLKMQgpx80e1wqhv6mLKjhdYrQeEC+e+gy39serT/wxrTJEGHUV0G0lf7RrRSKo -J2WGVRHUtTwqmbdZEF0zRNUvqT5mgVSf1jZ3u56jhMbjD9aPR007GikW6+V67Jdi -3sqXEJwU5bwDsREuHWXSo7otG/MyjCrIzR27gOlnTllKpgQ1fzVDuvpsU3W+1f6P -Gz8wkVlayi3iR/GT6X3/ApyDeR7aIgNdZA9CAsa/YAf6kfFdy6V9eLz1KeAh0s4V -QGARXIXdVzvvs8cUsG6qAoMzTMxdJzTHHfAu7p2LlR4wF34RukSIZs4qd2wNdHQW -bx4WhoxeeTl4e1f3LgpybMYSN9OZdyTiIUZUdc5ihJBrXdYmeaEaDY8bVsCwTK76 -JkDI36K2BXM6AvDM2581gHpx58S/Tm2B87iwa9A/Gd9SjUdLvsdhs/rCNQANTvL4 -zv//ueLDkswYNxhzhpUnAD+eYGB4x6wqa2nR860Ke6tWxDeMlTUKmoArXGjw5+pd -DkTeDn5FqpxSBgJcao9aQ7qU/VhD2kIUSol9Z/gD8aUXa6jjASpEfuTnaZrfLyF9 -sNb1Xh99UzLiU5KzVLtIDRsG1W3srVDlMCCr9vyWTtb6zUAVeEM= -=ln5n ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-sparc64.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-sparc64.asc deleted file mode 100644 index b01280586c..0000000000 --- a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC1-sparc64.asc +++ /dev/null @@ -1,25 +0,0 @@ ------BEGIN PGP SIGNED MESSAGE----- -Hash: SHA256 - -SHA256 (FreeBSD-12.3-RC1-sparc64-bootonly.iso) = 3ff39cbbd806fcc276b72d3049ab84f97951dfc9887d04daead44f727d090648 -SHA256 (FreeBSD-12.3-RC1-sparc64-bootonly.iso.xz) = 83b8fe63dea8daff851d82f2157aa80d3b5388bfb6fa87f78f6965d7908a3c9d -SHA256 (FreeBSD-12.3-RC1-sparc64-disc1.iso) = 74a9b4f71f366efbc55126f6ecb4f1ec66bcbfeee072eb2da5ddbf606c791d92 -SHA256 (FreeBSD-12.3-RC1-sparc64-disc1.iso.xz) = 216053082e11f6b4e4e367fdfd69e81bba886cef4963afe2cd1b5eceb51042d4 -SHA256 (FreeBSD-12.3-RC1-sparc64-dvd1.iso) = e4ac2fa9d2aad897b2cbca68561f4032aa03855a4739a4f7aa88ccf59b4e3d6d -SHA256 (FreeBSD-12.3-RC1-sparc64-dvd1.iso.xz) = 983b97da2c9a386524d89c4bf91e2943fc21b4d162cc40ee31671304a8eb95e1 ------BEGIN PGP SIGNATURE----- - -iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGNZTgACgkQAxRYpUeP -4pPBJA//R1a99q4D4AyKkAgQ8GFwCltOi729/V4eA/VzVvevLBN9fCKYruZHNmVb -OywUNqtWf0+NawubZBsx7AhaV4FVzV0TCPG/O07qKjppRmUXNV9i3+55sRXLzxxu -xXrCUa7PBlv0UrkYo+uEZvFNOoyn2EH+rYNIw/dQpu4ub9b1QhpYFsLnUZqJ2GRY -v2fffd98mIuo/BcARuZIWorT6sgrFp3APqSGL114fpJObuTMlkyVgqLBDx1P0043 -FeibK/dHuPTz9BNOPz567kOSbq7OPkYjZDdRR9Ub4L0nwAZxsMqIWpXZkhyhnyiG -l8xvmT8ah3DYCughGgtI3GsyA47fZtAEfuaIJ/07MNWAD2fK2MA4Y/umIN/SWySS -0FHJDua3U0mkeu5RFk8oV6sYBKNCD0wtuvHykI0u2AZqq7xKZ5CagHKWUuCVGZSC -cIAk1/FtwRM0E1vvJoegRcTG+BbovZS8+JGJPDZF3gJfS9sFmLlBRBfRl9ymNX6J -U4SbyRFTgIxIgGzMyM8JRMjnVsaE/vmemYsLpQw6XRNDYXbddjKgPCQj0R0wwabS -v3UzZfEYOr1J1yOtr9l0f866lYP0jAAPvv61zDZWY1e0U0xtvjDTYZlmrjufuYv9 -naEgTnQPCo/gp5n+RA6pZwlv8aObPtrk5LfcgVNaf1vTZFRwVIo= -=PLhZ ------END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-amd64-vm.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-amd64-vm.asc new file mode 100644 index 0000000000..7c08775752 --- /dev/null +++ b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-amd64-vm.asc @@ -0,0 +1,23 @@ +-----BEGIN PGP SIGNED MESSAGE----- +Hash: SHA256 + +SHA256 (FreeBSD-12.3-RC2-amd64.qcow2.xz) = e7115c1f9b9f3d350be12c106ed9d3147a973ee11c7fde19e5109a77ade17ce0 +SHA256 (FreeBSD-12.3-RC2-amd64.raw.xz) = 98c18d84032a9d8cb53463715a5775b81638254d7ee727cc8c732a7f028af2cb +SHA256 (FreeBSD-12.3-RC2-amd64.vhd.xz) = 284892a138117a485c9596c787a50016d0bef85d6bb12cd9dd08fc90f0b9f755 +SHA256 (FreeBSD-12.3-RC2-amd64.vmdk.xz) = 7099d8d1a5834ef192236ca3a6f538fd03072c082ff8a37691d307d58c099b17 +-----BEGIN PGP SIGNATURE----- + +iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGWnpUACgkQAxRYpUeP +4pNxexAAnqQ2/uI2BEMrvB0lPMxdvfwBebo0dA/OB1dAi6/E+LHSJ+Cz10WCIE3d +/jIcsZGEfX+SOoS/jK1lEwjEFTpkmbJIe3lDl+UL7meSniFuFG7824Y/kCpCB53q +hSwosHBRfa4k72zC/YzMVYDTvYGLgDe4JTmW7ioKXDbCx0VJjOPoDHUvM5GzfYED +mhcgK2X0FNYU54rhrJmSIOraA1vMQKu7ux/GErEsYHryvDXJUEz4DHhf0r9zj+RV +FCqS/gQw61vm4MUiFuGykNfy9cqqxmXWjEaAQm1ZC4QMcuELookMQ1XhQoelzC7R +lGWx4yCCRuhhTU8qDiJaDiyGq4LcRG2wq7qBJIs4/rXUie8vfm1BYHdITY2ddYQz +6JRh9Mjoe0Q+bWE2KP5PtqEHUzzzzT/nOioSbqpVb9OruIsUjgxVTZ513SuoP0eQ +eKzwvfenW0Ol+14vgh2VDBm8Hu0D3obVxs4NYxQjWv8ccxku0ZTxa+iSoTF41GlI +TjSdWHHNQMOHsxN3qPKQmT97/1iaLpQX66hqRDUwPrLN1OT54uN34tzEZNB1PpHt +XZJvZzWQjO4nwYBTJDdRFjakiIsYq6ruIkUtm/eodHkuymYfnksd1TxHpavgbalJ +tFkDqmIZOEOwYaVv0O2/WaanlazkONdxH9Wi+0fV4WBjSOoBmv8= +=WuyX +-----END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-amd64.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-amd64.asc new file mode 100644 index 0000000000..2c7c0be2a9 --- /dev/null +++ b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-amd64.asc @@ -0,0 +1,29 @@ +-----BEGIN PGP SIGNED MESSAGE----- +Hash: SHA256 + +SHA256 (FreeBSD-12.3-RC2-amd64-bootonly.iso) = 46107b4af1d51ded799b92d65006051e4ab3b498b5c0869d467592fc2716e4c9 +SHA256 (FreeBSD-12.3-RC2-amd64-bootonly.iso.xz) = 2403bbf39465c7c07fb1f1d88e69025630044dfbda167b764a8ec737ac37aa35 +SHA256 (FreeBSD-12.3-RC2-amd64-disc1.iso) = a38b81845e6e0a83edf042bf9c2f05a8d3f46e5c1495509d5e9a25db04597a6e +SHA256 (FreeBSD-12.3-RC2-amd64-disc1.iso.xz) = f34d70466448ebd0949b013bb2c57c190c69ef1130b5cb0958f4e5afb4f473b3 +SHA256 (FreeBSD-12.3-RC2-amd64-dvd1.iso) = 974e8c538014c3579ffbeecd7a47ac8b053359c0ab4671d315a602a505721e44 +SHA256 (FreeBSD-12.3-RC2-amd64-dvd1.iso.xz) = 5be5e61f460f1b7cd52697bdd69e7ab1ad5f5cff91500e1b32b27c73f1ce24e6 +SHA256 (FreeBSD-12.3-RC2-amd64-memstick.img) = 15c3115315d77b65b33cfdea06320bc158574d6b1daa0e8e2806801032833014 +SHA256 (FreeBSD-12.3-RC2-amd64-memstick.img.xz) = 8f16ab837835aebaa46fe52a0e80028f546375a29232ab5464fc51889ee53f24 +SHA256 (FreeBSD-12.3-RC2-amd64-mini-memstick.img) = a10e59edf70c91a40e85b33970008b9d6f71706a59224ee282cf4b0851f48402 +SHA256 (FreeBSD-12.3-RC2-amd64-mini-memstick.img.xz) = 8a18350ebe1a3c85da1e1d7d2b2e30fcc79a7ea8e94bb1ed3fdfc797c308f369 +-----BEGIN PGP SIGNATURE----- + +iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGWnpUACgkQAxRYpUeP +4pMxeRAAowTumag0UhEBP/GKH8Zpr3B5q6nx4j6hukA6oqiF9c+u9gax/QG5kdVz +xkya4tV6Y1HbWyLMWvG30g4j52TjV6Vu5bjftxAyEHwIENzZJ9pfxiwVAMOJ6v8o +VsFtjGKmE8Ak+1n6A6NqaA/VWrU3bharvqD1V/PbK6XiMd2or/BEFp3C4xXVsYln +0N+CcLEASOi4bU+lGl28HCmjErOJdse5oe3OLjfVhYYlElKrRBIkQY6nl6yZlfmP +Ht3ISX07J57I/6/dIsIJSiL+qluwXF2nLERSNv7O7QDHgHBTQ+ptfn6TMR29Qo8z +chM4Z55OsyrdEHcLko5Nvx/mqqOiUroECJqzS94o8zaOzdso6WRXMMb0MF1lcFWg +tYLVQQIKGReL9n/Nj6PHQIDRab82322PAyUx8sE6pI3jjPfK7YwAZJ5ZQasW3PgK ++A9z9vQEDN5iWtmXkdHXaupTHyHtROzNGWeexgiQsQ9U+OUtC/TuhPnLkG3pJ66M +XpNnhcon31t7C6FhiM66kE3oIS1q6GSJcwb7XACzu5W+MeFOw+bt57upMg2MDNmQ +yxMvhxORDnYYT5qTdAuX3UHr4eqhhTdtxtu5yMdRQaCOi1PmuKqHvyRkEXtTXSDq +24xIETCcGdWnIvPrLElWY/btSfYyZ2n6Bxz50wfAdgj6BBasgv8= +=KIfI +-----END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv6-RPI-B.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv6-RPI-B.asc new file mode 100644 index 0000000000..1c16728049 --- /dev/null +++ b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv6-RPI-B.asc @@ -0,0 +1,20 @@ +-----BEGIN PGP SIGNED MESSAGE----- +Hash: SHA256 + +SHA256 (FreeBSD-12.3-RC2-arm-armv6-RPI-B.img.xz) = 2558ce7cb62bf792536cbda981c01dc3ef55b61d202729819572ef72b3d3313a +-----BEGIN PGP SIGNATURE----- + +iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGWnpUACgkQAxRYpUeP +4pOZnBAAmvDbbHx/RY4xAxavj8iHPDv9dau7lRj3eiOv/etPCASPrZ4pFmmlYlkH +5/vAsKU5/F/0j1Xim0kD87xO6WVHJRdAxq+Xgm3VPAM4GjP4AhTppaWixiS0+5ZD +F6CzXKdx6I7owp5t4Od2r1sTVZhUegyyj/q5fiiqQ1EXXvdZBLkNmFauDb/14iAI +oQFsMEgMx8epROHumvcr2MWQRQo+vOaPggFL8bweHGXuFrAll062ihfwuGWZ2DA+ +6UquSA6otD6YNsqtz5t3nAqGK15mvsu/BiTOAic6sMFTyD0iasOcFuF2nm8j94rE +iepE2qSEU/8Us9VYs+QSOVJNxt12dFAhJX1I421NHf31p/X6CJDsTYz96MhGW5eq +fV1gxgH0YBlfS1ziM1nVa5eCBqE+627M4hps02/lRsFfjuq3w6BC66O5kpU5/Y3N +GAUadNSJYxaxukfKn51GgwWajMR4UIrjYltsNoHKulqIk7GOiJ1f33yRhhPN9s5B +WaSS/vV6T+bk6juYcugSybP/PMMYN5zaPFalJCATd6MqOW8kOhHZmL8Rzgzl/idj +yQtu16s/PcrfbI9sMj5nR6Guw5hgxigMjdmqh1zSjTFbIc6TFXY95dJoPmGyjRou +Bg2GEHmoUtxUHMhrErL0CymDAhLmbAQSJ431eKM3O4I/bfDhaZE= +=xXeW +-----END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-BANANAPI.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-BANANAPI.asc new file mode 100644 index 0000000000..df6f85d032 --- /dev/null +++ b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-BANANAPI.asc @@ -0,0 +1,20 @@ +-----BEGIN PGP SIGNED MESSAGE----- +Hash: SHA256 + +SHA256 (FreeBSD-12.3-RC2-arm-armv7-BANANAPI.img.xz) = 91cc48b3adf20399bad2e91c43a3bed26a47214c5b0e75903595d4cd5ce8ad78 +-----BEGIN PGP SIGNATURE----- + +iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGWnpUACgkQAxRYpUeP +4pN14xAAlnP0d+EcclSuEx8jpiyzo4GBFan9hcSGKdshO1uNLSa0UD3zGHqpS9SL ++gBOtGwZ/G094NdYT0a9DD7zuGVrtb2A0pSN6XteQ5dsCKGnL0kBDmqjGGBRD9SU +S5VyvvUxVmyN0J0MnNj3CqHp9uH4dQw7Br/77VcWiPPprg6XxYaM9rzFUeAYtwut +hYBvNHSZtW7hp6T5s9c9I9ArKJBYsxKYuy5my+zQEiunBnijSgCwU6BBeAkbXd43 +UbkfnQHIYZ+DBYXAGNH8x0Waid5ckK28ilXLjqi8Lhf9XSdKraWHQkpLAdCHVpwz +nDf4PEdhWsCm+v9AiIxcJrzPGFZAd281C5tE3xf2wJ3exhjQ87E6O8xMpFE9QsGD +4eOuk0jFNrmpNB/9Cc7TjLZeVOUffHDa3NSy8iNo9fhPAzvFpaTL7Lb8gbgUnVSl +nj6d2G2ZS7+wwYE+hS72fMlvjC44RvsZO9qkPW6pOinMIZpNRm0mKk9fA4P3sf92 +goHWyYeo01b3iWgE7FS+nqekHyfH/mwn1/lhFQMNEbrxirsMDo7wsNMtkPyAABL9 +zgDjxky156rBnfDXhEvzNtNY9H+8Dd4CTw+oDwozGOAr3rzVqfvGnDKk/SwRMLwj +EZLLySw4GMnNg9c3H5baqvsOJ2oL8YmgPkNiWbGZ27kLKG1amCY= +=XIVf +-----END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-CUBIEBOARD.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-CUBIEBOARD.asc new file mode 100644 index 0000000000..caf2e551e8 --- /dev/null +++ b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-CUBIEBOARD.asc @@ -0,0 +1,20 @@ +-----BEGIN PGP SIGNED MESSAGE----- +Hash: SHA256 + +SHA256 (FreeBSD-12.3-RC2-arm-armv7-CUBIEBOARD.img.xz) = 47a920af07eebb5b23fcf0ba03af8128a92d7e592e74e98722832fdfe553f6a9 +-----BEGIN PGP SIGNATURE----- + +iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGWnpUACgkQAxRYpUeP +4pODmg//ViQC+NnNp6aXewkr4BY44IGGO5ezJHWz/cYYyOblA4XfYEEbeWoxUV+f +RTCgV4ZHPRsG/jFZJurTIM4Rfe3G0YqjbEstCd19qfEpsYLNLzyRhU8uEA392TfE +dJiHae+m4s7DTw49WodgzcZP0O8i8adrOSTQ/Ae0SjfPNEj4qdZpGJQ2XcKKW67d +3qy1UdxFm+39kcIydSFMilOXAFjmdj3/7e4s9dQCY2SrW6B2D2uPIZOm+Epr6DYu +jiUNT8lp7OfOMDz70JXMsT7L6/kM6vBrc7Ta/J8hfDiD/R9oq49/jR+cAgg8EPWF +sm/xgGOlM9dgaiapj+v2OV7+jSF9EvirCdVNJkqQxXsnVwqT7shMpNV8THT/rZN7 +VCjPfjFVY+/l5hv8FqMf3FPvXqMmWJG0oE1I/R2Kafrt+JUy+TXpEhLbk7QspqD0 +PCNK/qgBvqF5vXMdwCwGLjCd+K8CvlX7Aby/oss5XvfYoyiQjqtBZMDN/viobLzK +rJnNo99icfOCIvf2MnFPOfGvfWX+i6/vCPhAKYUxR5jHhOYhmFFjt/E8gV1U6Eko +NRwQSDUwsHrIWrcLgnh8g5Jh1uX6bwGQk3EhgtBCaiyaZFUX1khm7QuFMWELrTMR +zJw1wl6qZYtzENxPzWDY6bn5jkarpY2+OyFHagqyu1AVzKUB3OQ= +=mnsx +-----END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-CUBIEBOARD2.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-CUBIEBOARD2.asc new file mode 100644 index 0000000000..78ad38ae98 --- /dev/null +++ b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-CUBIEBOARD2.asc @@ -0,0 +1,20 @@ +-----BEGIN PGP SIGNED MESSAGE----- +Hash: SHA256 + +SHA256 (FreeBSD-12.3-RC2-arm-armv7-CUBIEBOARD2.img.xz) = 470e7e143984821425b6b34a156bd73a82334c898be2319d70d0c352b6696426 +-----BEGIN PGP SIGNATURE----- + +iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGWnpUACgkQAxRYpUeP +4pMGQQ/+IQ54V6zp3UvYPSrC/K+l0WShI94pX47PiyG8g1iWbZbUu2K01fmtGqCo +gi29+rgWUWZQvqmArXRHb9NRP6E957roNf9VtCGx9vnb5ZxVxLNEodXrp7lXuxMN +j+tMijlL0Ad13rZtlJV2kekatGl2R3iTQn3y9aX6ulwNNsTn5eTdM521yNSCi124 +BuylChDOW7BRKxcM7HtQC4sepraRAKuUVAzZCoYHyTF6NUHH2VFxGV6jHMcipmO5 +Xp2jq6++c4euPSjqTCh8UXpI2hzr+q2Qdmng6KaPzZ5GVshfTXBvZeN4/mLeTxHX +yl6k6htK/dcn04g//vrLNtnGd3/j60vRLqqePCVolZv6p6ax0ERKoxQU/a2doq3Y +sSZCmgNNrS4F073SVvxRhIioXmQXG4Il3xPjqAu7Nj8bpGelekUoQDCdeM3z1Pt2 +IJZdRFq0SVMXwcMux9FSeStfDXDA5GSeIBVoNmxmd0Lk2iQ/l99s/1sldQjmMOck +4zt/VyTJCR05uuQDQnItaNE6LtiZW8X6N00C5gGpBxi+JS3mZdo99siAR3p7icsr +nBFKMRs4XbnshP1KOrfMMWj5BjkspUQoSm9d/4Vrup4PWNcnz3037EhP1GRiLK7b +BXAVw+OMksCl5QYj4iLbfSZf00P3Y4kfkp+lxvstaBlApk4tg1c= +=oatN +-----END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-CUBOX-HUMMINGBOARD.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-CUBOX-HUMMINGBOARD.asc new file mode 100644 index 0000000000..faa2732e89 --- /dev/null +++ b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-CUBOX-HUMMINGBOARD.asc @@ -0,0 +1,20 @@ +-----BEGIN PGP SIGNED MESSAGE----- +Hash: SHA256 + +SHA256 (FreeBSD-12.3-RC2-arm-armv7-CUBOX-HUMMINGBOARD.img.xz) = 2790ffa5a2d18c369cfdc078e0baeff7a28eeef15d04d1b613bfb82cff3c9033 +-----BEGIN PGP SIGNATURE----- + +iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGWnpUACgkQAxRYpUeP +4pOLAg//U7wGjVhRxL+1LIIMK/i8P0+yV32Xrb96DsZpdH2sfusClPM4RKMR/yHj +xR09lOjdT9fZgWIov+l0N9En5cWOiORbKY45bRVcWUB0tVMpnaz4yisJs/F5DnAu +a6wElCNALGqQUMlI6BQyeaiL5ZybFeAhHC9KGMRmEJE9SV47V60YGScNA140fhRV +0bhzIsUE9qtdqXzLw4W+PGvELq38NydToKZZm+TiGXMCPCNAuUVtCBKkhnk40/Rj +eIlv7vtLvAkMNYlOWV5g9qicchAoHwjXyZ0nU5sjXApkCKj1YOsE0eOSg5QWrS09 +D8ucUdyYa0bu/2hR2mtyjPpLB5ajeq588WfB1nRoaHsP5HLDsKYwrOLy5kCvhAEB +FeYUKYH4PNloJzI1X/VW5IoYMPaCvTTYy+qcFpsgdAgVIsvBFt8/PzRG2tkbWPaY +RWXyUHkJqg+TPYkUeENKGYnDq7UFOlCRptUtEhqgXqrsjqDOTp7KUYkWKHGgN2lg +l/TFbnTEOm7RFhuBt0hB00G3TtzOhiayya+NqZO0n7r/AClmWq/XMsdRb3V2KjMl +gDtZ2SC7Nmf9yeAx6/YGLHmElZmU1nzKkb1JvTF79o2DeegMPFL546pARY1z2EYo +gw/ps7Q6T63o08ZvS/Q4DWuzfIZu8iCamn5AmdltmTBSO64qyFk= +=X+pV +-----END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-GENERICSD.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-GENERICSD.asc new file mode 100644 index 0000000000..3c9f4b970c --- /dev/null +++ b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-GENERICSD.asc @@ -0,0 +1,20 @@ +-----BEGIN PGP SIGNED MESSAGE----- +Hash: SHA256 + +SHA256 (FreeBSD-12.3-RC2-arm-armv7-GENERICSD.img.xz) = a56d5cba4227e4c61c4a0e34a22a3f225373f1f76345643b742c6fa07966b09c +-----BEGIN PGP SIGNATURE----- + +iQIzBAEBCAAdFiEEjRJAPC5sqwhs9k2jAxRYpUeP4pMFAmGWnpUACgkQAxRYpUeP +4pOnWg//SUZlwOiEyQER76BUmhdI8R05Swd7QE+2uB0xvb4B8wXczkcDzse6vwjg +sMq11lzZ0W7I3I67qMDCyfZkQMe22ILTKQvhfbLwJ/jhKps0nl6RlPj9QBIuSLUj +LJy/BwfsWv8oG2XzJzD0R64YHXU9u2rbgmtF5ox53sZjm02KFfM4DdpdnhC9QWsS +eZEVGsl3CVHyyZr8iZDn+vsvYhCP4bObctJrWbFtuaHDSnBWnwLkbhgCegbmQsjV +0bChLpmcpa7jpICk+s+Yx0JhZvBTrKxkUOdBm9qHvDTGVncNndpB8er4kEZmjTNP +nheUnqLebsvZAK4JUMngd9pQvknMv/TOw37qvK3Bxk510PtkMxcTeaIf7IvFaIXW +myAc5nUMU21GQiIyUR2XshkFuNp0wlJGN7W917CX4mdnFMrlBddRpDHdeUcIP0O1 +O7ji267o3Wj1buVVuxfRS7ESv+uLrSJmRSryr8MttjsZ+BIcWBdPBYnqlJqXsjZ1 +r1QVxTFsHpa0T7gp0sqLQtviCJ3BWapAifKmn2qERuoGWMEh9+VaDD1GCdT2doxU +P81D9jJoW3lCA96cwbB+sa4Gi6AyqaCqPEecQ7wE7ve/zgVz6U03T6WS5I2KEqJR +d+0VlbMfG+y8oS0cElitISqUuHVwzlAb2O+RlfLPxGiSdEihD5w= +=XNkG +-----END PGP SIGNATURE----- diff --git a/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-RPI2.asc b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-RPI2.asc new file mode 100644 index 0000000000..6532bab74e --- /dev/null +++ b/website/content/en/releases/12.3R/checksums/CHECKSUM.SHA256-FreeBSD-12.3-RC2-arm-armv7-RPI2.asc @@ -0,0 +1,20 @@ +-----BEGIN PGP SIGNED MESSAGE----- +Hash: SHA256 + +SHA256 (FreeBSD-12.3-RC2-arm-armv7-RPI2.img.xz) = d87b755990c8ce802e7745ec3732d16dfad1f51890e27183ab89ee6ac2cc919f *** 1681 LINES SKIPPED *** From nobody Sun Nov 21 11:36:48 2021 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 1787718ACDB5 for ; Sun, 21 Nov 2021 11:36:49 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HxpJw742vz4qhg; Sun, 21 Nov 2021 11:36:48 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id CE7A86C00; Sun, 21 Nov 2021 11:36:48 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1ALBam4m036793; Sun, 21 Nov 2021 11:36:48 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1ALBamsh036792; Sun, 21 Nov 2021 11:36:48 GMT (envelope-from git) Date: Sun, 21 Nov 2021 11:36:48 GMT Message-Id: <202111211136.1ALBamsh036792@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: b50decfb86 - main - Update virtualization chapter 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: b50decfb86295ab97227274eae771275af801951 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=b50decfb86295ab97227274eae771275af801951 commit b50decfb86295ab97227274eae771275af801951 Author: Minsoo Choo AuthorDate: 2021-11-21 11:27:53 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-11-21 11:27:53 +0000 Update virtualization chapter * Delete Virtual PC. Windows 7 reached EoL in January 14, 2020. And Microsoft removed Virtual PC to download from their webpage. * Update VMware Fusion section. Reviewed by: @ygy, @carlavilla Approved by: @carlavilla Differential Revision: https://reviews.freebsd.org/D30145 --- documentation/.hugo_build.lock | 0 .../en/books/handbook/virtualization/_index.adoc | 184 +++++++-------------- .../handbook/virtualization/vmware-freebsd01.png | Bin 47523 -> 429432 bytes .../handbook/virtualization/vmware-freebsd02.png | Bin 106943 -> 385588 bytes .../handbook/virtualization/vmware-freebsd03.png | Bin 83909 -> 462872 bytes .../handbook/virtualization/vmware-freebsd04.png | Bin 85009 -> 374030 bytes .../handbook/virtualization/vmware-freebsd05.png | Bin 90391 -> 402799 bytes .../handbook/virtualization/vmware-freebsd06.png | Bin 104721 -> 416184 bytes .../handbook/virtualization/vmware-freebsd07.png | Bin 37324 -> 562446 bytes .../handbook/virtualization/vmware-freebsd08.png | Bin 34080 -> 530694 bytes .../handbook/virtualization/vmware-freebsd09.png | Bin 97054 -> 215816 bytes .../handbook/virtualization/vmware-freebsd10.png | Bin 93968 -> 781356 bytes .../handbook/virtualization/vmware-freebsd11.png | Bin 95234 -> 498163 bytes .../handbook/virtualization/vmware-freebsd12.png | Bin 96489 -> 312370 bytes .../handbook/virtualization/vmware-freebsd13.png | Bin 0 -> 400805 bytes 15 files changed, 56 insertions(+), 128 deletions(-) diff --git a/documentation/.hugo_build.lock b/documentation/.hugo_build.lock new file mode 100644 index 0000000000..e69de29bb2 diff --git a/documentation/content/en/books/handbook/virtualization/_index.adoc b/documentation/content/en/books/handbook/virtualization/_index.adoc index 683b917b02..dd8c97b7ba 100644 --- a/documentation/content/en/books/handbook/virtualization/_index.adoc +++ b/documentation/content/en/books/handbook/virtualization/_index.adoc @@ -54,9 +54,11 @@ Such software systems for PCs often involve a host operating system which runs t After reading this chapter, you will know: * The difference between a host operating system and a guest operating system. -* How to install FreeBSD on an Intel(R)-based Apple(R) Mac(R) computer. -* How to install FreeBSD on Microsoft(R) Windows(R) with Virtual PC. -* How to install FreeBSD as a guest in bhyve. +* How to install FreeBSD on the following virtualization platforms: +** Parallels Desktop(Intel(R)-based Apple(R) macOS(R)) +** VMware Fusion(Intel(R)-based Apple(R) macOS(R)) +** VirtualBox(TM)(Microsoft(R) Windows(R), Intel(R)-based Apple(R) macOS(R), Linux) +** bhyve(FreeBSD) * How to tune a FreeBSD system for best performance under virtualization. Before reading this chapter, you should: @@ -66,15 +68,15 @@ Before reading this chapter, you should: * Know how to crossref:advanced-networking[advanced-networking,set up a network connection]. * Know how to crossref:ports[ports,install additional third-party software]. -[[virtualization-guest-parallels]] -== FreeBSD as a Guest on Parallels for Mac OS(R) X +[[virtualization-guest-parallelsdesktop]] +== FreeBSD as a Guest on Parallels Desktop for macOS(R) -Parallels Desktop for Mac(R) is a commercial software product available for Intel(R) based Apple(R) Mac(R) computers running Mac OS(R) 10.4.6 or higher. +Parallels Desktop for Mac(R) is a commercial software product available for Intel(R) based Apple(R) Mac(R) computers running macOS(R) 10.4.6 or higher. FreeBSD is a fully supported guest operating system. -Once Parallels has been installed on Mac OS(R) X, the user must configure a virtual machine and then install the desired guest operating system. +Once Parallels has been installed on macOS(R), the user must configure a virtual machine and then install the desired guest operating system. -[[virtualization-guest-parallels-install]] -=== Installing FreeBSD on Parallels/Mac OS(R) X +[[virtualization-guest-parallelsdesktop-install]] +=== Installing FreeBSD on Parallels Desktop on Mac(R) The first step in installing FreeBSD on Parallels is to create a new virtual machine for installing FreeBSD. Select [.guimenuitem]#FreeBSD# as the menu:Guest OS Type[] when prompted: @@ -129,7 +131,7 @@ image::parallels-freebsd13.png[] [[virtualization-guest-parallels-configure]] === Configuring FreeBSD on Parallels -After FreeBSD has been successfully installed on Mac OS(R) X with Parallels, there are a number of configuration steps that can be taken to optimize the system for virtualized operation. +After FreeBSD has been successfully installed on macOS(R) X with Parallels, there are a number of configuration steps that can be taken to optimize the system for virtualized operation. [.procedure] . Set Boot Loader Variables @@ -154,171 +156,88 @@ The most basic networking setup uses DHCP to connect the virtual machine to the This can be accomplished by adding `ifconfig_ed0="DHCP"` to [.filename]#/etc/rc.conf#. More advanced networking setups are described in crossref:advanced-networking[advanced-networking,Advanced Networking]. -[[virtualization-guest-virtualpc]] -== FreeBSD as a Guest on Virtual PC for Windows(R) - -Virtual PC for Windows(R) is a Microsoft(R) software product available for free download. -See this website for the http://www.microsoft.com/windows/downloads/virtualpc/sysreq.mspx[system requirements]. -Once Virtual PC has been installed on Microsoft(R) Windows(R), the user can configure a virtual machine and then install the desired guest operating system. - -[[virtualization-guest-virtualpc-install]] -=== Installing FreeBSD on Virtual PC - -The first step in installing FreeBSD on Virtual PC is to create a new virtual machine for installing FreeBSD. -Select [.guimenuitem]#Create a virtual machine# when prompted: - -image::virtualpc-freebsd1.png[] - -image::virtualpc-freebsd2.png[] - -Select [.guimenuitem]#Other# as the [.guimenuitem]#Operating system# when prompted: - -image::virtualpc-freebsd3.png[] - -Then, choose a reasonable amount of disk and memory depending on the plans for this virtual FreeBSD instance. -4GB of disk space and 512MB of RAM work well for most uses of FreeBSD under Virtual PC: - -image::virtualpc-freebsd4.png[] - -image::virtualpc-freebsd5.png[] - -Save and finish the configuration: - -image::virtualpc-freebsd6.png[] - -Select the FreeBSD virtual machine and click menu:Settings[], then set the type of networking and a network interface: - -image::virtualpc-freebsd7.png[] - -image::virtualpc-freebsd8.png[] - -After the FreeBSD virtual machine has been created, FreeBSD can be installed on it. -This is best done with an official FreeBSD CD/DVD or with an ISO image downloaded from an official FTP site. -Copy the appropriate ISO image to the local Windows(R) filesystem or insert a CD/DVD in the CD drive, then double click on the FreeBSD virtual machine to boot. -Then, click menu:CD[] and choose menu:Capture ISO Image...[] on the Virtual PC window. -This will bring up a window where the CD-ROM drive in the virtual machine can be associated with an ISO file on disk or with the real CD-ROM drive. - -image::virtualpc-freebsd9.png[] - -image::virtualpc-freebsd10.png[] - -Once this association with the CD-ROM source has been made, reboot the FreeBSD virtual machine by clicking menu:Action[] and menu:Reset[]. -Virtual PC will reboot with a special BIOS that first checks for a CD-ROM. - -image::virtualpc-freebsd11.png[] - -In this case it will find the FreeBSD installation media and begin a normal FreeBSD installation. -Continue with the installation, but do not attempt to configure Xorg at this time. - -image::virtualpc-freebsd12.png[] - -When the installation is finished, remember to eject the CD/DVD or release the ISO image. -Finally, reboot into the newly installed FreeBSD virtual machine. - -image::virtualpc-freebsd13.png[] - -[[virtualization-guest-virtualpc-configure]] -=== Configuring FreeBSD on Virtual PC - -After FreeBSD has been successfully installed on Microsoft(R) Windows(R) with Virtual PC, there are a number of configuration steps that can be taken to optimize the system for virtualized operation. - -[.procedure] -. Set Boot Loader Variables -+ -The most important step is to reduce the `kern.hz` tunable to reduce the CPU utilization of FreeBSD under the Virtual PC environment. -This is accomplished by adding the following line to [.filename]#/boot/loader.conf#: -+ -[.programlisting] -.... -kern.hz=100 -.... -+ -Without this setting, an idle FreeBSD Virtual PC guest OS will use roughly 40% of the CPU of a single processor computer. -After this change, the usage will be closer to 3%. -. Create a New Kernel Configuration File -+ -All of the SCSI, FireWire, and USB device drivers can be removed from a custom kernel configuration file. -Virtual PC provides a virtual network adapter used by the man:de[4] driver, so all network devices except for man:de[4] and man:miibus[4] can be removed from the kernel. -. Configure Networking -+ -The most basic networking setup uses DHCP to connect the virtual machine to the same local area network as the Microsoft(R) Windows(R) host. -This can be accomplished by adding `ifconfig_de0="DHCP"` to [.filename]#/etc/rc.conf#. -More advanced networking setups are described in crossref:advanced-networking[advanced-networking,Advanced Networking]. - [[virtualization-guest-vmware]] -== FreeBSD as a Guest on VMware Fusion for Mac OS(R) +== FreeBSD as a Guest on VMware Fusion for macOS(R) -VMware Fusion for Mac(R) is a commercial software product available for Intel(R) based Apple(R) Mac(R) computers running Mac OS(R) 10.4.9 or higher. +VMware Fusion for Mac(R) is a commercial software product available for Intel(R) based Apple(R) Mac(R) computers running macOS(R) 10.11 or higher. FreeBSD is a fully supported guest operating system. -Once VMware Fusion has been installed on Mac OS(R) X, the user can configure a virtual machine and then install the desired guest operating system. +Once VMware Fusion has been installed on macOS(R), the user can configure a virtual machine and then install the desired guest operating system. [[virtualization-guest-vmware-install]] === Installing FreeBSD on VMware Fusion The first step is to start VMware Fusion which will load the Virtual Machine Library. -Click [.guimenuitem]#New# to create the virtual machine: +Click [.guimenuitem]#+->New# to create the virtual machine: -image::vmware-freebsd01.png[] +image::vmware-freebsd01.png[width=35%] This will load the New Virtual Machine Assistant. -Click [.guimenuitem]#Continue# to proceed: +Choose [.guimenuitem]#Create a custom virtual machine# and click [.guimenuitem]#Continue# to proceed: + +image::vmware-freebsd02.png[width=45%] + +Select [.guimenuitem]#Other# as the [.guimenuitem]#Operating System# and either [.guimenuitem]#FreeBSD X# or [.guimenuitem]#FreeBSD X 64-bit#, as the menu:Version[] when prompted: + +image::vmware-freebsd03.png[width=45%] -image::vmware-freebsd02.png[] +Choose the firmware(UEFI is recommended): -Select [.guimenuitem]#Other# as the [.guimenuitem]#Operating System# and either [.guimenuitem]#FreeBSD# or [.guimenuitem]#FreeBSD 64-bit#, as the menu:Version[] when prompted: +image::vmware-freebsd04.png[width=45%] -image::vmware-freebsd03.png[] +Choose [.guimenuitem]#Create a new virtual disk# and click [.guimenuitem]#Continue#: + +image::vmware-freebsd05.png[width=45%] + +Check the configuration and click [.guimenuitem]#Finish#: + +image::vmware-freebsd06.png[width=45%] Choose the name of the virtual machine and the directory where it should be saved: -image::vmware-freebsd04.png[] +image::vmware-freebsd07.png[width=45%] -Choose the size of the Virtual Hard Disk for the virtual machine: +Press command+E to open virtual machine settings and click [.guimenuitem]#CD/DVD#: -image::vmware-freebsd05.png[] +image::vmware-freebsd08.png[width=45%] -Choose the method to install the virtual machine, either from an ISO image or from a CD/DVD: +Choose FreeBSD ISO image or from a CD/DVD: -image::vmware-freebsd06.png[] +image::vmware-freebsd09.png[width=45%] -Click [.guimenuitem]#Finish# and the virtual machine will boot: +Start the virtual machine: -image::vmware-freebsd07.png[] +image::vmware-freebsd10.png[width=25%] Install FreeBSD as usual: -image::vmware-freebsd08.png[] +image::vmware-freebsd11.png[width=25%] -Once the install is complete, the settings of the virtual machine can be modified, such as memory usage: +Once the install is complete, the settings of the virtual machine can be modified, such as memory usage and the number of CPUs the virtual machine will have access to: [NOTE] ==== The System Hardware settings of the virtual machine cannot be modified while the virtual machine is running. ==== -image::vmware-freebsd09.png[] - -The number of CPUs the virtual machine will have access to: - -image::vmware-freebsd10.png[] +image::vmware-freebsd12.png[width=45%] The status of the CD-ROM device. Normally the CD/DVD/ISO is disconnected from the virtual machine when it is no longer needed. -image::vmware-freebsd11.png[] +image::vmware-freebsd09.png[width=45%] The last thing to change is how the virtual machine will connect to the network. To allow connections to the virtual machine from other machines besides the host, choose [.guimenuitem]#Connect directly to the physical network (Bridged)#. Otherwise, [.guimenuitem]#Share the host's internet connection (NAT)# is preferred so that the virtual machine can have access to the Internet, but the network cannot access the virtual machine. -image::vmware-freebsd12.png[] +image::vmware-freebsd13.png[width=45%] After modifying the settings, boot the newly installed FreeBSD virtual machine. [[virtualization-guest-vmware-configure]] === Configuring FreeBSD on VMware Fusion -After FreeBSD has been successfully installed on Mac OS(R) X with VMware Fusion, there are a number of configuration steps that can be taken to optimize the system for virtualized operation. +After FreeBSD has been successfully installed on macOS(R) X with VMware Fusion, there are a number of configuration steps that can be taken to optimize the system for virtualized operation. [.procedure] . Set Boot Loader Variables @@ -342,6 +261,15 @@ VMware Fusion provides a virtual network adapter used by the man:em[4] driver, s The most basic networking setup uses DHCP to connect the virtual machine to the same local area network as the host Mac(R). This can be accomplished by adding `ifconfig_em0="DHCP"` to [.filename]#/etc/rc.conf#. More advanced networking setups are described in crossref:advanced-networking[advanced-networking,Advanced Networking]. ++ +. Install drivers and open-vm-tools ++ +To run FreeBSD smoothly on VMWare, drivers should be installed: ++ +[source,shell] +.... +# pkg install xf86-video-vmware xf86-input-vmmouse open-vm-tools +.... [[virtualization-guest-virtualbox]] == FreeBSD as a Guest on VirtualBox(TM) @@ -466,7 +394,7 @@ Mount the shared folder from within the guest system like this: [[virtualization-host-virtualbox]] == FreeBSD as a Host with VirtualBox(TM) -VirtualBox(TM) is an actively developed, complete virtualization package, that is available for most operating systems including Windows(R), Mac OS(R), Linux(R) and FreeBSD. +VirtualBox(TM) is an actively developed, complete virtualization package, that is available for most operating systems including Windows(R), macOS(R), Linux(R) and FreeBSD. It is equally capable of running Windows(R) or UNIX(R)-like guests. It is released as open source software, but with closed-source components available in a separate extension pack. These components include support for USB 2.0 devices. diff --git a/documentation/static/images/books/handbook/virtualization/vmware-freebsd01.png b/documentation/static/images/books/handbook/virtualization/vmware-freebsd01.png index 3b0db00593..75a800944c 100644 Binary files a/documentation/static/images/books/handbook/virtualization/vmware-freebsd01.png and b/documentation/static/images/books/handbook/virtualization/vmware-freebsd01.png differ diff --git a/documentation/static/images/books/handbook/virtualization/vmware-freebsd02.png b/documentation/static/images/books/handbook/virtualization/vmware-freebsd02.png index cdc351b905..8ce2dc1c23 100644 Binary files a/documentation/static/images/books/handbook/virtualization/vmware-freebsd02.png and b/documentation/static/images/books/handbook/virtualization/vmware-freebsd02.png differ diff --git a/documentation/static/images/books/handbook/virtualization/vmware-freebsd03.png b/documentation/static/images/books/handbook/virtualization/vmware-freebsd03.png index cfecc3dbbc..b96a2911e2 100644 Binary files a/documentation/static/images/books/handbook/virtualization/vmware-freebsd03.png and b/documentation/static/images/books/handbook/virtualization/vmware-freebsd03.png differ diff --git a/documentation/static/images/books/handbook/virtualization/vmware-freebsd04.png b/documentation/static/images/books/handbook/virtualization/vmware-freebsd04.png index b77969fd70..c8548cf59f 100644 Binary files a/documentation/static/images/books/handbook/virtualization/vmware-freebsd04.png and b/documentation/static/images/books/handbook/virtualization/vmware-freebsd04.png differ diff --git a/documentation/static/images/books/handbook/virtualization/vmware-freebsd05.png b/documentation/static/images/books/handbook/virtualization/vmware-freebsd05.png index a40e2298b4..ee4d51fbb4 100644 Binary files a/documentation/static/images/books/handbook/virtualization/vmware-freebsd05.png and b/documentation/static/images/books/handbook/virtualization/vmware-freebsd05.png differ diff --git a/documentation/static/images/books/handbook/virtualization/vmware-freebsd06.png b/documentation/static/images/books/handbook/virtualization/vmware-freebsd06.png index f8787623cb..6bc298c713 100644 Binary files a/documentation/static/images/books/handbook/virtualization/vmware-freebsd06.png and b/documentation/static/images/books/handbook/virtualization/vmware-freebsd06.png differ diff --git a/documentation/static/images/books/handbook/virtualization/vmware-freebsd07.png b/documentation/static/images/books/handbook/virtualization/vmware-freebsd07.png index f9e344297b..8313a5aae3 100644 Binary files a/documentation/static/images/books/handbook/virtualization/vmware-freebsd07.png and b/documentation/static/images/books/handbook/virtualization/vmware-freebsd07.png differ diff --git a/documentation/static/images/books/handbook/virtualization/vmware-freebsd08.png b/documentation/static/images/books/handbook/virtualization/vmware-freebsd08.png index 25496349b9..e4613ed66d 100644 Binary files a/documentation/static/images/books/handbook/virtualization/vmware-freebsd08.png and b/documentation/static/images/books/handbook/virtualization/vmware-freebsd08.png differ diff --git a/documentation/static/images/books/handbook/virtualization/vmware-freebsd09.png b/documentation/static/images/books/handbook/virtualization/vmware-freebsd09.png index cccd147aeb..222a249c1a 100644 Binary files a/documentation/static/images/books/handbook/virtualization/vmware-freebsd09.png and b/documentation/static/images/books/handbook/virtualization/vmware-freebsd09.png differ diff --git a/documentation/static/images/books/handbook/virtualization/vmware-freebsd10.png b/documentation/static/images/books/handbook/virtualization/vmware-freebsd10.png index a1ce39948c..a2a6f1f42f 100644 Binary files a/documentation/static/images/books/handbook/virtualization/vmware-freebsd10.png and b/documentation/static/images/books/handbook/virtualization/vmware-freebsd10.png differ diff --git a/documentation/static/images/books/handbook/virtualization/vmware-freebsd11.png b/documentation/static/images/books/handbook/virtualization/vmware-freebsd11.png index 7c1542396c..3e7fef6c1c 100644 Binary files a/documentation/static/images/books/handbook/virtualization/vmware-freebsd11.png and b/documentation/static/images/books/handbook/virtualization/vmware-freebsd11.png differ diff --git a/documentation/static/images/books/handbook/virtualization/vmware-freebsd12.png b/documentation/static/images/books/handbook/virtualization/vmware-freebsd12.png index c4ebac1a63..2d12e312a6 100644 Binary files a/documentation/static/images/books/handbook/virtualization/vmware-freebsd12.png and b/documentation/static/images/books/handbook/virtualization/vmware-freebsd12.png differ diff --git a/documentation/static/images/books/handbook/virtualization/vmware-freebsd13.png b/documentation/static/images/books/handbook/virtualization/vmware-freebsd13.png new file mode 100644 index 0000000000..640632512a Binary files /dev/null and b/documentation/static/images/books/handbook/virtualization/vmware-freebsd13.png differ From nobody Sun Nov 21 12:27:59 2021 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 788C7189D0E1 for ; Sun, 21 Nov 2021 12:27:59 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HxqRz2zjtz3MwS; Sun, 21 Nov 2021 12:27:59 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 467BE7612; Sun, 21 Nov 2021 12:27:59 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1ALCRx3r003763; Sun, 21 Nov 2021 12:27:59 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1ALCRxMA003762; Sun, 21 Nov 2021 12:27:59 GMT (envelope-from git) Date: Sun, 21 Nov 2021 12:27:59 GMT Message-Id: <202111211227.1ALCRxMA003762@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: "Danilo G. Baio" Subject: git: cd71c465b9 - main - tools/translate.sh: Improve usage 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: dbaio X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: cd71c465b97d7563bedda9cb265afc91a84c80de Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by dbaio: URL: https://cgit.FreeBSD.org/doc/commit/?id=cd71c465b97d7563bedda9cb265afc91a84c80de commit cd71c465b97d7563bedda9cb265afc91a84c80de Author: Danilo G. Baio AuthorDate: 2021-11-20 14:06:22 +0000 Commit: Danilo G. Baio CommitDate: 2021-11-21 12:24:20 +0000 tools/translate.sh: Improve usage - Update .po file with the source document before translating. - Allow translation of a specific document. Translate all es documents: ./tools/translate.sh documentation es Translate only pt-br articles/bsdl-gpl: ./tools/translate.sh documentation pt-br articles/bsdl-gpl Reviewed by: fernape Differential Revision: https://reviews.freebsd.org/D33067 --- tools/translate.sh | 22 +++++++++++++++++++--- 1 file changed, 19 insertions(+), 3 deletions(-) diff --git a/tools/translate.sh b/tools/translate.sh index c5a4ab895e..10be78aa05 100755 --- a/tools/translate.sh +++ b/tools/translate.sh @@ -54,13 +54,16 @@ fixup_includes() } if [ "$1" = "" ] || [ "$2" = "" ]; then - echo "Need to inform which component and|or language." - echo "$0 documentation|website pt_BR|es" + echo "Need to inform component and language:" + echo " $0 documentation es" + echo "A third (optional) argument can be informed to translate only a specific document:" + echo " $0 documentation pt-br articles/bsdl-gpl" exit 1 fi COMPONENT="$1" LANGUAGE="$2" +SEARCH_RESTRICT="$3" # po4a-translate option: -k, --keep # Minimal threshold for translation percentage to keep (i.e. write) @@ -79,7 +82,7 @@ if [ ! -d "$COMPONENT/content/$LANGUAGE" ]; then exit 1 fi -for pofile in $(find "$COMPONENT/content/$LANGUAGE/" -name "*.po" ); do +for pofile in $(find "$COMPONENT/content/$LANGUAGE/$SEARCH_RESTRICT" -name "*.po"); do name=$(basename -s .po "$pofile") if [ "$name" = "chapters-order" ]; then continue @@ -92,6 +95,19 @@ for pofile in $(find "$COMPONENT/content/$LANGUAGE/" -name "*.po" ); do echo "....." echo "$pofile" + po4a-updatepo \ + --format asciidoc \ + --option compat=asciidoctor \ + --option yfm_keys=title,part,description \ + --master "$adoc_orig" \ + --master-charset "UTF-8" \ + --copyright-holder "The FreeBSD Project" \ + --package-name "FreeBSD Documentation" \ + --po "$pofile" + if [ -f "${pofile}~" ]; then + rm -f "${pofile}~" + fi + po4a-translate \ --format asciidoc \ --option compat=asciidoctor \ From nobody Sun Nov 21 17:15:04 2021 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 C704618A018B for ; Sun, 21 Nov 2021 17:15:04 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HxxqD59r0z4g96; Sun, 21 Nov 2021 17:15:04 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 8FE571334C; Sun, 21 Nov 2021 17:15:04 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1ALHF45R088872; Sun, 21 Nov 2021 17:15:04 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1ALHF4S1088871; Sun, 21 Nov 2021 17:15:04 GMT (envelope-from git) Date: Sun, 21 Nov 2021 17:15:04 GMT Message-Id: <202111211715.1ALHF4S1088871@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 0ea062e716 - main - Remove Virtual PC from tags 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 0ea062e71692f4554368b5d15eef468868e4d3e3 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=0ea062e71692f4554368b5d15eef468868e4d3e3 commit 0ea062e71692f4554368b5d15eef468868e4d3e3 Author: Minsoo Choo AuthorDate: 2021-11-21 17:13:40 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-11-21 17:13:40 +0000 Remove Virtual PC from tags Approved by: carlavilla@ Differential Revision: https://reviews.freebsd.org/D33069 --- documentation/content/en/books/handbook/virtualization/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/books/handbook/virtualization/_index.adoc b/documentation/content/en/books/handbook/virtualization/_index.adoc index dd8c97b7ba..c1838cd0cb 100644 --- a/documentation/content/en/books/handbook/virtualization/_index.adoc +++ b/documentation/content/en/books/handbook/virtualization/_index.adoc @@ -4,7 +4,7 @@ part: Part III. System Administration prev: books/handbook/filesystems next: books/handbook/l10n description: Virtualization software allows multiple operating systems to run simultaneously on the same computer -tags: ["virtualization", "Parallels", "Virtual PC", "VMware", "VirtualBox", "bhyve", "XEN"] +tags: ["virtualization", "Parallels", "VMware", "VirtualBox", "bhyve", "XEN"] --- [[virtualization]] From nobody Sun Nov 21 17:33:04 2021 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 C95DF18A8B04 for ; Sun, 21 Nov 2021 17:33:04 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HxyD05JP8z4lkw; Sun, 21 Nov 2021 17:33:04 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 9613D13472; Sun, 21 Nov 2021 17:33:04 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1ALHX4UA014819; Sun, 21 Nov 2021 17:33:04 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1ALHX4K8014818; Sun, 21 Nov 2021 17:33:04 GMT (envelope-from git) Date: Sun, 21 Nov 2021 17:33:04 GMT Message-Id: <202111211733.1ALHX4K8014818@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 2291b365c7 - main - Fix manual page link in basics handbook chapter 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 2291b365c7be7d155cfff337ffeef54bbfb11c3a Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=2291b365c7be7d155cfff337ffeef54bbfb11c3a commit 2291b365c7be7d155cfff337ffeef54bbfb11c3a Author: Sergio Carlavilla Delgado AuthorDate: 2021-11-21 17:31:13 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-11-21 17:31:13 +0000 Fix manual page link in basics handbook chapter Submitted by: Marin Bernard PR: 259972 --- documentation/content/en/books/handbook/basics/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/books/handbook/basics/_index.adoc b/documentation/content/en/books/handbook/basics/_index.adoc index 8ab50fce94..4d721e02d3 100644 --- a/documentation/content/en/books/handbook/basics/_index.adoc +++ b/documentation/content/en/books/handbook/basics/_index.adoc @@ -114,7 +114,7 @@ When switching from one console to the next, FreeBSD manages the screen output. The result is an illusion of having multiple virtual screens and keyboards that can be used to type commands for FreeBSD to run. The programs that are launched in one virtual console do not stop running when the user switches to a different virtual console. -Refer to man:kbdcontrol[1], man:vidcontrol[1], man:atkbd:[4], man:syscons[4], and man:vt[4] for a more technical description of the FreeBSD console and its keyboard drivers. +Refer to man:kbdcontrol[1], man:vidcontrol[1], man:atkbd[4], man:syscons[4], and man:vt[4] for a more technical description of the FreeBSD console and its keyboard drivers. In FreeBSD, the number of available virtual consoles is configured in this section of [.filename]#/etc/ttys#: From nobody Sun Nov 21 19:04:19 2021 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 CE74118927A6 for ; Sun, 21 Nov 2021 19:04:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Hy0FH2sqLz4Sng; Sun, 21 Nov 2021 19:04:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4175214BB8; Sun, 21 Nov 2021 19:04:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1ALJ4JRS041859; Sun, 21 Nov 2021 19:04:19 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1ALJ4JfY041858; Sun, 21 Nov 2021 19:04:19 GMT (envelope-from git) Date: Sun, 21 Nov 2021 19:04:19 GMT Message-Id: <202111211904.1ALJ4JfY041858@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: c0a1c8e922 - main - Split German developers handbook 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c0a1c8e9223b13a174895fc60840f7490728ec1c Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=c0a1c8e9223b13a174895fc60840f7490728ec1c commit c0a1c8e9223b13a174895fc60840f7490728ec1c Author: Sergio Carlavilla Delgado AuthorDate: 2021-11-21 19:03:58 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-11-21 19:03:58 +0000 Split German developers handbook --- .../de/books/developers-handbook/_index.adoc | 41 ++--------- .../bibliography/{chapter.adoc => _index.adoc} | 2 +- .../content/de/books/developers-handbook/book.adoc | 84 ++++++++++++++++++++++ .../books/developers-handbook/chapters-order.adoc | 29 ++++---- .../introduction/{chapter.adoc => _index.adoc} | 2 +- .../ipv6/{chapter.adoc => _index.adoc} | 2 +- .../kernelbuild/{chapter.adoc => _index.adoc} | 2 +- .../kerneldebug/{chapter.adoc => _index.adoc} | 2 +- .../l10n/{chapter.adoc => _index.adoc} | 0 .../de/books/developers-handbook/parti.adoc | 18 +++++ .../de/books/developers-handbook/partii.adoc | 18 +++++ .../de/books/developers-handbook/partiii.adoc | 18 +++++ .../de/books/developers-handbook/partiv.adoc | 19 +++++ .../de/books/developers-handbook/partv.adoc | 18 +++++ .../policies/{chapter.adoc => _index.adoc} | 0 .../secure/{chapter.adoc => _index.adoc} | 8 +-- .../sockets/{chapter.adoc => _index.adoc} | 2 +- .../testing/{chapter.adoc => _index.adoc} | 2 +- .../tools/{chapter.adoc => _index.adoc} | 0 .../x86/{chapter.adoc => _index.adoc} | 4 +- 20 files changed, 210 insertions(+), 61 deletions(-) diff --git a/documentation/content/de/books/developers-handbook/_index.adoc b/documentation/content/de/books/developers-handbook/_index.adoc index 00e1073cdd..3f4829289d 100644 --- a/documentation/content/de/books/developers-handbook/_index.adoc +++ b/documentation/content/de/books/developers-handbook/_index.adoc @@ -4,21 +4,22 @@ authors: - author: The FreeBSD Documentation Project copyright: 1995-2020 The FreeBSD Documentation Project trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"] +next: books/developers-handbook/parti +add_single_page_link: true isIndex: true --- = FreeBSD Developers' Handbook :doctype: book :toc: macro -:toclevels: 2 +:toclevels: 1 :icons: font :sectnums: :sectnumlevels: 6 :partnums: :source-highlighter: rouge :experimental: -:book: true -:pdf: false +:images-path: books/developers-handbook/ ifdef::env-beastie[] ifdef::backend-html5[] @@ -56,36 +57,4 @@ Die aktuelle Version dieses Handbuchs ist immer auf dem http://www.FreeBSD.org/[ toc::[] -// Section one -[[basics]] -= Grundlagen - -include::{chapters-path}introduction/chapter.adoc[leveloffset=+1] -include::{chapters-path}tools/chapter.adoc[leveloffset=+1] -include::{chapters-path}secure/chapter.adoc[leveloffset=+1] -include::{chapters-path}l10n/chapter.adoc[leveloffset=+1] -include::{chapters-path}policies/chapter.adoc[leveloffset=+1] -include::{chapters-path}testing/chapter.adoc[leveloffset=+1] - -// Section two -[[ipc]] -= Interprozess-Kommunikation -include::{chapters-path}sockets/chapter.adoc[leveloffset=+1] -include::{chapters-path}ipv6/chapter.adoc[leveloffset=+1] - -// Section three -[[kernel]] -= Kernel -include::{chapters-path}kernelbuild/chapter.adoc[leveloffset=+1] -include::{chapters-path}kerneldebug/chapter.adoc[leveloffset=+1] - -// Section four -[[architectures]] -= Architekturen -include::{chapters-path}x86/chapter.adoc[leveloffset=+1] - -// Appendices -[[appendices]] -= Anhang - -include::{chapters-path}bibliography/chapter.adoc[leveloffset=+1] +include::{chapters-path}toc.adoc[] diff --git a/documentation/content/de/books/developers-handbook/bibliography/chapter.adoc b/documentation/content/de/books/developers-handbook/bibliography/_index.adoc similarity index 97% rename from documentation/content/de/books/developers-handbook/bibliography/chapter.adoc rename to documentation/content/de/books/developers-handbook/bibliography/_index.adoc index 37c2d499e2..929ecb7a1f 100644 --- a/documentation/content/de/books/developers-handbook/bibliography/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/bibliography/_index.adoc @@ -1,6 +1,6 @@ --- title: Literaturverzeichnis -prev: books/developers-handbook/x86 +prev: books/developers-handbook/partv --- [bibliography] diff --git a/documentation/content/de/books/developers-handbook/book.adoc b/documentation/content/de/books/developers-handbook/book.adoc new file mode 100644 index 0000000000..f1e3428e0a --- /dev/null +++ b/documentation/content/de/books/developers-handbook/book.adoc @@ -0,0 +1,84 @@ +--- +title: FreeBSD Developers' Handbook +authors: + - author: The FreeBSD Documentation Project +copyright: 1995-2020 The FreeBSD Documentation Project +trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"] +add_split_page_link: true +--- + += FreeBSD Developers' Handbook +:doctype: book +:toc: macro +:toclevels: 2 +:icons: font +:sectnums: +:sectnumlevels: 6 +:partnums: +:source-highlighter: rouge +:experimental: +:book: true +:pdf: false + +ifdef::env-beastie[] +ifdef::backend-html5[] +include::shared/authors.adoc[] +include::shared/mirrors.adoc[] +include::shared/releases.adoc[] +include::shared/attributes/attributes-{{% lang %}}.adoc[] +include::shared/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/urls.adoc[] +:chapters-path: content/{{% lang %}}/books/developers-handbook/ +endif::[] +ifdef::backend-pdf,backend-epub3[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] +endif::[] + +ifndef::env-beastie[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] + +[.abstract-title] +[abstract] +Zusammenfassung + +Willkommen zum Entwickler-Handbuch. Dieses Handbuch ist _jederzeit unter Bearbeitung_ und das Ergebnis der Arbeit vieler Einzelpersonen. Dies kann dazu führen, dass bestimmte Bereiche nicht mehr aktuell sind und auf den neuesten Stand gebracht werden müssen. Bei Unklarheiten empfiehlt es sich daher stets, auch die extref:{developers-handbook}[englische Originalversion] des Handbuchs zu lesen. + +Wenn Sie bei der Übersetzung dieses Handbuchs mithelfen möchten, senden Sie bitte eine E-Mail an die Mailingliste {de-doc}. + +Die aktuelle Version dieses Handbuchs ist immer auf dem http://www.FreeBSD.org/[FreeBSD-Webserver] verfügbar und kann in verschiedenen Formaten und in komprimierter Form vom link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc[FreeBSD-FTP-Server] oder einem der zahlreichen extref:{handbook}mirrors/[Spiegel, mirrors-ftp] heruntergeladen werden (ältere Versionen finden Sie hingegen unter http://docs.FreeBSD.org/doc/[http://docs.FreeBSD.org/doc/]). + +''' + +toc::[] + +// Section one +include::{chapters-path}parti.adoc[lines=15..16] +include::{chapters-path}introduction/_index.adoc[leveloffset=+1] +include::{chapters-path}tools/_index.adoc[leveloffset=+1] +include::{chapters-path}secure/_index.adoc[leveloffset=+1] +include::{chapters-path}l10n/_index.adoc[leveloffset=+1] +include::{chapters-path}policies/_index.adoc[leveloffset=+1] +include::{chapters-path}testing/_index.adoc[leveloffset=+1] + +// Section two +include::{chapters-path}partii.adoc[lines=15..16] +include::{chapters-path}sockets/_index.adoc[leveloffset=+1] +include::{chapters-path}ipv6/_index.adoc[leveloffset=+1] + +// Section three +include::{chapters-path}partiii.adoc[lines=15..16] +include::{chapters-path}kernelbuild/_index.adoc[leveloffset=+1] +include::{chapters-path}kerneldebug/_index.adoc[leveloffset=+1] + +// Section four +include::{chapters-path}partiv.adoc[lines=15..16] +include::{chapters-path}x86/_index.adoc[leveloffset=+1] + +// Appendices +include::{chapters-path}partv.adoc[lines=15..16] +include::{chapters-path}bibliography/_index.adoc[leveloffset=+1] diff --git a/documentation/content/de/books/developers-handbook/chapters-order.adoc b/documentation/content/de/books/developers-handbook/chapters-order.adoc index 90183764d6..ef978f645c 100644 --- a/documentation/content/de/books/developers-handbook/chapters-order.adoc +++ b/documentation/content/de/books/developers-handbook/chapters-order.adoc @@ -1,12 +1,17 @@ -introduction/chapter.adoc -tools/chapter.adoc -secure/chapter.adoc -l10n/chapter.adoc -policies/chapter.adoc -testing/chapter.adoc -sockets/chapter.adoc -ipv6/chapter.adoc -kernelbuild/chapter.adoc -kerneldebug/chapter.adoc -x86/chapter.adoc -bibliography/chapter.adoc +parti.adoc +introduction/_index.adoc +tools/_index.adoc +secure/_index.adoc +l10n/_index.adoc +policies/_index.adoc +testing/_index.adoc +partii.adoc +sockets/_index.adoc +ipv6/_index.adoc +partiii.adoc +kernelbuild/_index.adoc +kerneldebug/_index.adoc +partiv.adoc +x86/_index.adoc +partv.adoc +bibliography/_index.adoc diff --git a/documentation/content/de/books/developers-handbook/introduction/chapter.adoc b/documentation/content/de/books/developers-handbook/introduction/_index.adoc similarity index 99% rename from documentation/content/de/books/developers-handbook/introduction/chapter.adoc rename to documentation/content/de/books/developers-handbook/introduction/_index.adoc index 12e216ef87..3f8e9f8641 100644 --- a/documentation/content/de/books/developers-handbook/introduction/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/introduction/_index.adoc @@ -1,6 +1,6 @@ --- title: Kapitel 1. Einführung -prev: books/developers-handbook/ +prev: books/developers-handbook/parti next: books/developers-handbook/tools --- diff --git a/documentation/content/de/books/developers-handbook/ipv6/chapter.adoc b/documentation/content/de/books/developers-handbook/ipv6/_index.adoc similarity index 99% rename from documentation/content/de/books/developers-handbook/ipv6/chapter.adoc rename to documentation/content/de/books/developers-handbook/ipv6/_index.adoc index 6610b447e7..f593b8eddc 100644 --- a/documentation/content/de/books/developers-handbook/ipv6/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/ipv6/_index.adoc @@ -1,7 +1,7 @@ --- title: Kapitel 8. IPv6 Internals prev: books/developers-handbook/sockets -next: books/developers-handbook/kernelbuild +next: books/developers-handbook/partiii --- [[ipv6]] diff --git a/documentation/content/de/books/developers-handbook/kernelbuild/chapter.adoc b/documentation/content/de/books/developers-handbook/kernelbuild/_index.adoc similarity index 98% rename from documentation/content/de/books/developers-handbook/kernelbuild/chapter.adoc rename to documentation/content/de/books/developers-handbook/kernelbuild/_index.adoc index 2402b2b5b0..6bdfb90624 100644 --- a/documentation/content/de/books/developers-handbook/kernelbuild/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/kernelbuild/_index.adoc @@ -1,6 +1,6 @@ --- title: Kapitel 9. Einen FreeBSD-Kernel bauen und installieren -prev: books/developers-handbook/ipv6 +prev: books/developers-handbook/partiii next: books/developers-handbook/kerneldebug --- diff --git a/documentation/content/de/books/developers-handbook/kerneldebug/chapter.adoc b/documentation/content/de/books/developers-handbook/kerneldebug/_index.adoc similarity index 99% rename from documentation/content/de/books/developers-handbook/kerneldebug/chapter.adoc rename to documentation/content/de/books/developers-handbook/kerneldebug/_index.adoc index 1e3aabb544..7afb5d9591 100644 --- a/documentation/content/de/books/developers-handbook/kerneldebug/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/kerneldebug/_index.adoc @@ -5,7 +5,7 @@ authors: - author: Jörg Wunsch - author: Robert Watson prev: books/developers-handbook/kernelbuild -next: books/developers-handbook/x86 +next: books/developers-handbook/partiv --- [[kerneldebug]] diff --git a/documentation/content/de/books/developers-handbook/l10n/chapter.adoc b/documentation/content/de/books/developers-handbook/l10n/_index.adoc similarity index 100% rename from documentation/content/de/books/developers-handbook/l10n/chapter.adoc rename to documentation/content/de/books/developers-handbook/l10n/_index.adoc diff --git a/documentation/content/de/books/developers-handbook/parti.adoc b/documentation/content/de/books/developers-handbook/parti.adoc new file mode 100644 index 0000000000..922ea617fe --- /dev/null +++ b/documentation/content/de/books/developers-handbook/parti.adoc @@ -0,0 +1,18 @@ +--- +title: Teil I. Grundlagen +prev: books/developers-handbook +next: books/developers-handbook/introduction +--- + +ifdef::env-beastie+backend-html5[] +:chapters-path: content/{{% lang %}}/books/developers-handbook/ +endif::[] + +ifndef::env-beastie[] +:chapters-path: +endif::[] + +[[basics]] += Grundlagen + +include::{chapters-path}toc-1.adoc[] diff --git a/documentation/content/de/books/developers-handbook/partii.adoc b/documentation/content/de/books/developers-handbook/partii.adoc new file mode 100644 index 0000000000..c22c2c69b4 --- /dev/null +++ b/documentation/content/de/books/developers-handbook/partii.adoc @@ -0,0 +1,18 @@ +--- +title: Teil II. Interprozess-Kommunikation +prev: books/developers-handbook/testing +next: books/developers-handbook/sockets +--- + +ifdef::env-beastie+backend-html5[] +:chapters-path: content/{{% lang %}}/books/developers-handbook/ +endif::[] + +ifndef::env-beastie[] +:chapters-path: +endif::[] + +[[ipc]] += Interprozess-Kommunikation + +include::{chapters-path}toc-2.adoc[] diff --git a/documentation/content/de/books/developers-handbook/partiii.adoc b/documentation/content/de/books/developers-handbook/partiii.adoc new file mode 100644 index 0000000000..d60c283535 --- /dev/null +++ b/documentation/content/de/books/developers-handbook/partiii.adoc @@ -0,0 +1,18 @@ +--- +title: Teil III. Kernel +prev: books/developers-handbook/ipv6 +next: books/developers-handbook/kernelbuild +--- + +ifdef::env-beastie+backend-html5[] +:chapters-path: content/{{% lang %}}/books/developers-handbook/ +endif::[] + +ifndef::env-beastie[] +:chapters-path: +endif::[] + +[[kernel]] += Kernel + +include::{chapters-path}toc-3.adoc[] diff --git a/documentation/content/de/books/developers-handbook/partiv.adoc b/documentation/content/de/books/developers-handbook/partiv.adoc new file mode 100644 index 0000000000..ddbb74d94e --- /dev/null +++ b/documentation/content/de/books/developers-handbook/partiv.adoc @@ -0,0 +1,19 @@ +--- +title: Teil IV. Architekturen +prev: books/developers-handbook/kerneldebug +next: books/developers-handbook/x86 +--- + +ifdef::env-beastie+backend-html5[] +:chapters-path: content/{{% lang %}}/books/developers-handbook/ +endif::[] + +ifndef::env-beastie[] +:chapters-path: +endif::[] + +[[architectures]] += Architekturen + +include::{chapters-path}toc-4.adoc[] + diff --git a/documentation/content/de/books/developers-handbook/partv.adoc b/documentation/content/de/books/developers-handbook/partv.adoc new file mode 100644 index 0000000000..4543335af2 --- /dev/null +++ b/documentation/content/de/books/developers-handbook/partv.adoc @@ -0,0 +1,18 @@ +--- +title: Teil V. Anhang +prev: books/developers-handbook/x86 +next: books/developers-handbook/bibliography +--- + +ifdef::env-beastie+backend-html5[] +:chapters-path: content/{{% lang %}}/books/developers-handbook/ +endif::[] + +ifndef::env-beastie[] +:chapters-path: +endif::[] + +[[appendices]] += Anhang + +include::{chapters-path}toc-5.adoc[] diff --git a/documentation/content/de/books/developers-handbook/policies/chapter.adoc b/documentation/content/de/books/developers-handbook/policies/_index.adoc similarity index 100% rename from documentation/content/de/books/developers-handbook/policies/chapter.adoc rename to documentation/content/de/books/developers-handbook/policies/_index.adoc diff --git a/documentation/content/de/books/developers-handbook/secure/chapter.adoc b/documentation/content/de/books/developers-handbook/secure/_index.adoc similarity index 94% rename from documentation/content/de/books/developers-handbook/secure/chapter.adoc rename to documentation/content/de/books/developers-handbook/secure/_index.adoc index 4407013162..ae66e1e19f 100644 --- a/documentation/content/de/books/developers-handbook/secure/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/secure/_index.adoc @@ -59,9 +59,9 @@ Eine der Stolperfallen der UNIX(R)-Umgebung ist, dass es sehr einfach ist Annahm [[secure-bufferov]] == Puffer-Überläufe -Puffer-Überläufe gibt es schon seit den Anfängen der Von-Neuman-Architektur <>. Sie erlangten zum ersten Mal durch den Internetwurm Morris im Jahre 1988 öffentliche Bekanntheit. Unglücklicherweise funktioniert der gleiche grundlegende Angriff noch heute. Die bei weitem häufigste Form eines Puffer-Überlauf-Angriffs basiert darauf, den Stack zu korrumpieren. +Puffer-Überläufe gibt es schon seit den Anfängen der Von-Neuman-Architektur crossref:bibliography[cod,1]. Sie erlangten zum ersten Mal durch den Internetwurm Morris im Jahre 1988 öffentliche Bekanntheit. Unglücklicherweise funktioniert der gleiche grundlegende Angriff noch heute. Die bei weitem häufigste Form eines Puffer-Überlauf-Angriffs basiert darauf, den Stack zu korrumpieren. -Die meisten modernen Computer-Systeme verwenden einen Stack, um Argumente an Prozeduren zu übergeben und lokale Variablen zu speichern. Ein Stack ist ein last-in-first-out-Puffer (LIFO) im hohen Speicherbereich eines Prozesses. Wenn ein Programm eine Funktion aufruft wird ein neuer "Stackframe" erzeugt. Dieser besteht aus den Argumenten, die der Funktion übergeben wurden und einem variabel grossem Bereich für lokale Variablen. Der "Stack-Pointer" ist ein Register, dass die aktuelle Adresse der Stack-Spitze enthält. Da sich dieser Wert oft ändert, wenn neue Werte auf dem Stack abgelegt werden, bieten viele Implementierungen einen "Frame-Pointer", der nahe am Anfang des Stack-Frames liegt und es so leichter macht lokale Variablen relativ zum aktuellen Stackframe zu adressieren. <> Die Rücksprungadresse der Funktionen werden ebenfalls auf dem Stack gespeichert und das ist der Grund für Stack-Überlauf-Exploits. Denn ein böswilliger Nutzer kann die Rücksprungadresse der Funktion überschreiben indem er eine lokale Variable in der Funktion überlaufen lässt, wodurch es ihm möglich ist beliebigen Code auszuführen. +Die meisten modernen Computer-Systeme verwenden einen Stack, um Argumente an Prozeduren zu übergeben und lokale Variablen zu speichern. Ein Stack ist ein last-in-first-out-Puffer (LIFO) im hohen Speicherbereich eines Prozesses. Wenn ein Programm eine Funktion aufruft wird ein neuer "Stackframe" erzeugt. Dieser besteht aus den Argumenten, die der Funktion übergeben wurden und einem variabel grossem Bereich für lokale Variablen. Der "Stack-Pointer" ist ein Register, dass die aktuelle Adresse der Stack-Spitze enthält. Da sich dieser Wert oft ändert, wenn neue Werte auf dem Stack abgelegt werden, bieten viele Implementierungen einen "Frame-Pointer", der nahe am Anfang des Stack-Frames liegt und es so leichter macht lokale Variablen relativ zum aktuellen Stackframe zu adressieren. crossref:bibliography[cod,1] Die Rücksprungadresse der Funktionen werden ebenfalls auf dem Stack gespeichert und das ist der Grund für Stack-Überlauf-Exploits. Denn ein böswilliger Nutzer kann die R ücksprungadresse der Funktion überschreiben indem er eine lokale Variable in der Funktion überlaufen lässt, wodurch es ihm möglich ist beliebigen Code auszuführen. Obwohl Stack-basierte Angriffe bei weitem die Häufigsten sind, ist es auch möglich den Stack mit einem Heap-basierten (malloc/free) Angriff zu überschreiben. @@ -109,7 +109,7 @@ Kann den Puffer str überlaufen lassen === Puffer-Überlauf Beispiel -Das folgende Quellcode-Beispiel enthält einen Puffer-Überlauf, der darauf ausgelegt ist die Rücksprungadresse zu überschreiben und die Anweisung direkt nach dem Funktionsaufruf zu überspringen. (Inspiriert durch <>) +Das folgende Quellcode-Beispiel enthält einen Puffer-Überlauf, der darauf ausgelegt ist die Rücksprungadresse zu überschreiben und die Anweisung direkt nach dem Funktionsaufruf zu überspringen. (Inspiriert durch crossref:bibliography[Phrack,4]) [.programlisting] .... @@ -144,7 +144,7 @@ Offensichtlich kann man durch böswilligere Eingaben bereits kompilierten Progra Die direkteste Lösung, um Stack-Überläufe zu vermeiden, ist immer grössenbegrenzten Speicher und String-Copy-Funktionen zu verwenden. `strncpy` und `strncat` sind Teil der C-Standardbibliothek. Diese Funktionen akzeptieren einen Längen-Parameter. Dieser Wert sollte nicht größer sein als die Länge des Zielpuffers. Die Funktionen kopieren dann bis zu `length` Bytes von der Quelle zum Ziel. Allerdings gibt es einige Probleme. Keine der Funktionen garantiert, dass die Zeichenkette NUL-terminiert ist, wenn die Größe des Eingabepuffers so groß ist wie das Ziel. Außerdem wird der Parameter length zwischen strncpy und strncat inkonsistent definiert, weshalb Programmierer leicht bezüglich der korrekten Verwendung durcheinander kommen können. Weiterhin gibt es einen spürbaren Leistungsverlust im Vergleich zu `strcpy`, wenn eine kurze Zeichenkette in einen großen Puffer kopiert wird. Denn `strncpy` fült den Puffer bis zur angegebenen Länge mit NUL auf. -In OpenBSD wurde eine weitere Möglichkeit zum kopieren von Speicherbereichen implementiert, die dieses Problem umgeht. Die Funktionen `strlcpy` und `strlcat` garantieren, dass das Ziel immer NUL-terminiert wird, wenn das Argument length ungleich null ist. Für weitere Informationen über diese Funktionen lesen Sie bitte <>. Die OpenBSD-Funktionen `strlcpy` und `strlcat` sind seit Version 3.3 auch in FreeBSD verfügbar. +In OpenBSD wurde eine weitere Möglichkeit zum kopieren von Speicherbereichen implementiert, die dieses Problem umgeht. Die Funktionen `strlcpy` und `strlcat` garantieren, dass das Ziel immer NUL-terminiert wird, wenn das Argument length ungleich null ist. Für weitere Informationen über diese Funktionen lesen Sie bitte crossref:bibliography[OpenBSD,6]. Die OpenBSD-Funktionen `strlcpy` und `strlcat` sind seit Version 3.3 auch in FreeBSD verfügbar. ==== Compiler-basierte Laufzeitüberprüfung von Grenzen diff --git a/documentation/content/de/books/developers-handbook/sockets/chapter.adoc b/documentation/content/de/books/developers-handbook/sockets/_index.adoc similarity index 96% rename from documentation/content/de/books/developers-handbook/sockets/chapter.adoc rename to documentation/content/de/books/developers-handbook/sockets/_index.adoc index 9ec9f3a459..ec674e1759 100644 --- a/documentation/content/de/books/developers-handbook/sockets/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/sockets/_index.adoc @@ -2,7 +2,7 @@ title: Kapitel 7. Sockets authors: - author: G. Adam Stanislav -prev: books/developers-handbook/testing +prev: books/developers-handbook/partii next: books/developers-handbook/ipv6 --- diff --git a/documentation/content/de/books/developers-handbook/testing/chapter.adoc b/documentation/content/de/books/developers-handbook/testing/_index.adoc similarity index 99% rename from documentation/content/de/books/developers-handbook/testing/chapter.adoc rename to documentation/content/de/books/developers-handbook/testing/_index.adoc index ea7fd0efac..7dbde48073 100644 --- a/documentation/content/de/books/developers-handbook/testing/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/testing/_index.adoc @@ -1,7 +1,7 @@ --- title: Kapitel 6. Regressions- und Performance-Tests prev: books/developers-handbook/policies -next: books/developers-handbook/sockets +next: books/developers-handbook/partii --- [[testing]] diff --git a/documentation/content/de/books/developers-handbook/tools/chapter.adoc b/documentation/content/de/books/developers-handbook/tools/_index.adoc similarity index 100% rename from documentation/content/de/books/developers-handbook/tools/chapter.adoc rename to documentation/content/de/books/developers-handbook/tools/_index.adoc diff --git a/documentation/content/de/books/developers-handbook/x86/chapter.adoc b/documentation/content/de/books/developers-handbook/x86/_index.adoc similarity index 99% rename from documentation/content/de/books/developers-handbook/x86/chapter.adoc rename to documentation/content/de/books/developers-handbook/x86/_index.adoc index f4830a5735..4ec4bfaf90 100644 --- a/documentation/content/de/books/developers-handbook/x86/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/x86/_index.adoc @@ -1,7 +1,7 @@ --- title: Kapitel 11. x86-Assembler-Programmierung -prev: books/developers-handbook/kerneldebug -next: books/developers-handbook/bibliography +prev: books/developers-handbook/partiv +next: books/developers-handbook/partv --- [[x86]] From nobody Sun Nov 21 20:05:25 2021 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 764B0188A7F3 for ; Sun, 21 Nov 2021 20:05:26 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Hy1bp2c0pz4qvX; Sun, 21 Nov 2021 20:05:26 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 19987157B0; Sun, 21 Nov 2021 20:05:26 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1ALK5P98022014; Sun, 21 Nov 2021 20:05:25 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1ALK5PNc022013; Sun, 21 Nov 2021 20:05:25 GMT (envelope-from git) Date: Sun, 21 Nov 2021 20:05:25 GMT Message-Id: <202111212005.1ALK5PNc022013@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 120050663b - main - Add missing paragraph in rc-scripting article 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 120050663b8dee82c7c2f6d7246392ff0d94ac24 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=120050663b8dee82c7c2f6d7246392ff0d94ac24 commit 120050663b8dee82c7c2f6d7246392ff0d94ac24 Author: Rocky Hotas AuthorDate: 2021-11-21 20:04:38 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-11-21 20:04:38 +0000 Add missing paragraph in rc-scripting article PR: 259832 Approved by: carlavilla@ --- .../content/en/articles/rc-scripting/_index.adoc | 23 ++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/documentation/content/en/articles/rc-scripting/_index.adoc b/documentation/content/en/articles/rc-scripting/_index.adoc index 750072951e..bc939aec04 100644 --- a/documentation/content/en/articles/rc-scripting/_index.adoc +++ b/documentation/content/en/articles/rc-scripting/_index.adoc @@ -685,6 +685,29 @@ From all the files to be dependency sorted, man:rcorder[8] will pick only those In FreeBSD, man:rcorder[8] is used by [.filename]#/etc/rc# and [.filename]#/etc/rc.shutdown#. These two scripts define the standard list of FreeBSD [.filename]#rc.d# keywords and their meanings as follows: +nojail:: The service is not for man:jail[8] environment. +The automatic startup and shutdown procedures will ignore the script if inside a jail. + +nostart:: The service is to be started manually or not started at all. +The automatic startup procedure will ignore the script. +In conjunction with the [.filename]#shutdown# keyword, this can be used to write scripts that do something only at system shutdown. + +shutdown:: This keyword is to be listed __explicitly__ if the service needs to be stopped before system shutdown. + +[NOTE] +==== +When the system is going to shut down, [.filename]#/etc/rc.shutdown# runs. +It assumes that most [.filename]#rc.d# scripts have nothing to do at that time. +Therefore [.filename]#/etc/rc.shutdown# selectively invokes [.filename]#rc.d# scripts with the [.filename]#shutdown# keyword, effectively ignoring the rest of the scripts. +For even faster shutdown, [.filename]#/etc/rc.shutdown# passes the [.filename]#faststop# command to the scripts it runs so that they skip preliminary checks, e.g., the pidfile check. +As dependent services should be stopped before their prerequisites, [.filename]#/etc/rc.shutdown# runs the scripts in reverse dependency order. +If writing a real [.filename]#rc.d# script, you should consider whether it is relevant at system shutdown time. +E.g., if your script does its work in response to the [.filename]#start# command only, then you need not to include this keyword. +However, if your script manages a service, it is probably a good idea to stop it before the system proceeds to the final stage of its shutdown sequence described in man:halt[8]. +In particular, a service should be stopped explicitly if it needs considerable time or special actions to shut down cleanly. +A typical example of such a service is a database engine. +==== + [[forcedep]]➎ To begin with, `force_depend` should be used with much care. It is generally better to revise the hierarchy of configuration variables for your [.filename]#rc.d# scripts if they are interdependent. From nobody Sun Nov 21 21:05:34 2021 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 8D2E718AC6DB for ; Sun, 21 Nov 2021 21:05:34 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Hy2xB3Gcwz3mFC; Sun, 21 Nov 2021 21:05:34 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4C3BF1678B; Sun, 21 Nov 2021 21:05:34 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1ALL5YFG001416; Sun, 21 Nov 2021 21:05:34 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1ALL5YPO001415; Sun, 21 Nov 2021 21:05:34 GMT (envelope-from git) Date: Sun, 21 Nov 2021 21:05:34 GMT Message-Id: <202111212105.1ALL5YPO001415@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 7d39fb6d23 - main - Split Traditional Chinese developers handbook 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 7d39fb6d2394704b59b2e06c70103e6c8dfdba67 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=7d39fb6d2394704b59b2e06c70103e6c8dfdba67 commit 7d39fb6d2394704b59b2e06c70103e6c8dfdba67 Author: Sergio Carlavilla Delgado AuthorDate: 2021-11-21 21:04:10 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-11-21 21:04:10 +0000 Split Traditional Chinese developers handbook Split Traditional Chinese developers handbook and remove toc macro in German developers handbook index file --- .../de/books/developers-handbook/_index.adoc | 2 - .../content/de/books/developers-handbook/book.adoc | 2 +- .../zh-tw/books/developers-handbook/_index.adoc | 39 ++-------- .../bibliography/{chapter.adoc => _index.adoc} | 2 +- .../zh-tw/books/developers-handbook/book.adoc | 82 ++++++++++++++++++++++ .../books/developers-handbook/chapters-order.adoc | 29 ++++---- .../introduction/{chapter.adoc => _index.adoc} | 2 +- .../ipv6/{chapter.adoc => _index.adoc} | 2 +- .../kernelbuild/{chapter.adoc => _index.adoc} | 2 +- .../kerneldebug/{chapter.adoc => _index.adoc} | 2 +- .../l10n/{chapter.adoc => _index.adoc} | 0 .../zh-tw/books/developers-handbook/parti.adoc | 18 +++++ .../zh-tw/books/developers-handbook/partii.adoc | 18 +++++ .../zh-tw/books/developers-handbook/partiii.adoc | 18 +++++ .../zh-tw/books/developers-handbook/partiv.adoc | 19 +++++ .../zh-tw/books/developers-handbook/partv.adoc | 18 +++++ .../policies/{chapter.adoc => _index.adoc} | 0 .../secure/{chapter.adoc => _index.adoc} | 6 +- .../sockets/{chapter.adoc => _index.adoc} | 2 +- .../testing/{chapter.adoc => _index.adoc} | 2 +- .../tools/{chapter.adoc => _index.adoc} | 2 +- .../x86/{chapter.adoc => _index.adoc} | 4 +- 22 files changed, 208 insertions(+), 63 deletions(-) diff --git a/documentation/content/de/books/developers-handbook/_index.adoc b/documentation/content/de/books/developers-handbook/_index.adoc index 3f4829289d..8e0f81165b 100644 --- a/documentation/content/de/books/developers-handbook/_index.adoc +++ b/documentation/content/de/books/developers-handbook/_index.adoc @@ -55,6 +55,4 @@ Die aktuelle Version dieses Handbuchs ist immer auf dem http://www.FreeBSD.org/[ ''' -toc::[] - include::{chapters-path}toc.adoc[] diff --git a/documentation/content/de/books/developers-handbook/book.adoc b/documentation/content/de/books/developers-handbook/book.adoc index f1e3428e0a..c4cf490cfd 100644 --- a/documentation/content/de/books/developers-handbook/book.adoc +++ b/documentation/content/de/books/developers-handbook/book.adoc @@ -80,5 +80,5 @@ include::{chapters-path}partiv.adoc[lines=15..16] include::{chapters-path}x86/_index.adoc[leveloffset=+1] // Appendices -include::{chapters-path}partv.adoc[lines=15..16] +include::{chapters-path}partv.adoc[lines=15..16] include::{chapters-path}bibliography/_index.adoc[leveloffset=+1] diff --git a/documentation/content/zh-tw/books/developers-handbook/_index.adoc b/documentation/content/zh-tw/books/developers-handbook/_index.adoc index 6a63a67756..53047771e7 100644 --- a/documentation/content/zh-tw/books/developers-handbook/_index.adoc +++ b/documentation/content/zh-tw/books/developers-handbook/_index.adoc @@ -4,21 +4,21 @@ authors: - author: FreeBSD 文件計畫 copyright: 1995-2020 The FreeBSD Documentation Project trademarks: ["freebsd", "ibm", "ieee", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "general"] +next: books/developers-handbook/parti +add_single_page_link: true isIndex: true --- = FreeBSD Developers' Handbook :doctype: book :toc: macro -:toclevels: 2 +:toclevels: 1 :icons: font :sectnums: :sectnumlevels: 6 :partnums: :source-highlighter: rouge :experimental: -:book: true -:pdf: false :images-path: books/developers-handbook/ ifdef::env-beastie[] @@ -53,35 +53,4 @@ endif::[] ''' -toc::[] - -// Section one -[[basics]] -= 基本概念 - -include::{chapters-path}introduction/chapter.adoc[leveloffset=+1] -include::{chapters-path}tools/chapter.adoc[leveloffset=+1] -include::{chapters-path}secure/chapter.adoc[leveloffset=+1] -include::{chapters-path}l10n/chapter.adoc[leveloffset=+1] -include::{chapters-path}policies/chapter.adoc[leveloffset=+1] -include::{chapters-path}testing/chapter.adoc[leveloffset=+1] - -// Section two -[[ipc]] -= Interprocess Communication(IPC) -include::{chapters-path}sockets/chapter.adoc[leveloffset=+1] -include::{chapters-path}ipv6/chapter.adoc[leveloffset=+1] - -// Section three -[[kernel]] -= Kernel(核心) -include::{chapters-path}kernelbuild/chapter.adoc[leveloffset=+1] -include::{chapters-path}kerneldebug/chapter.adoc[leveloffset=+1] - -// Section four -[[architectures]] -= Architectures(電腦架構) -include::{chapters-path}x86/chapter.adoc[leveloffset=+1] - -// Appendices -include::{chapters-path}bibliography/chapter.adoc[leveloffset=+1] +include::{chapters-path}toc.adoc[] diff --git a/documentation/content/zh-tw/books/developers-handbook/bibliography/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/bibliography/_index.adoc similarity index 97% rename from documentation/content/zh-tw/books/developers-handbook/bibliography/chapter.adoc rename to documentation/content/zh-tw/books/developers-handbook/bibliography/_index.adoc index 1642722b36..662ad09265 100644 --- a/documentation/content/zh-tw/books/developers-handbook/bibliography/chapter.adoc +++ b/documentation/content/zh-tw/books/developers-handbook/bibliography/_index.adoc @@ -1,6 +1,6 @@ --- title: 附錄 -prev: books/developers-handbook/x86 +prev: books/developers-handbook/partv --- [bibliography] diff --git a/documentation/content/zh-tw/books/developers-handbook/book.adoc b/documentation/content/zh-tw/books/developers-handbook/book.adoc new file mode 100644 index 0000000000..bd34ef3d63 --- /dev/null +++ b/documentation/content/zh-tw/books/developers-handbook/book.adoc @@ -0,0 +1,82 @@ +--- +title: FreeBSD Developers' Handbook +authors: + - author: FreeBSD 文件計畫 +copyright: 1995-2020 The FreeBSD Documentation Project +trademarks: ["freebsd", "ibm", "ieee", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "general"] +add_split_page_link: true +--- + += FreeBSD Developers' Handbook +:doctype: book +:toc: macro +:toclevels: 2 +:icons: font +:sectnums: +:sectnumlevels: 6 +:partnums: +:source-highlighter: rouge +:experimental: +:book: true +:pdf: false + +ifdef::env-beastie[] +ifdef::backend-html5[] +include::shared/authors.adoc[] +include::shared/mirrors.adoc[] +include::shared/releases.adoc[] +include::shared/attributes/attributes-{{% lang %}}.adoc[] +include::shared/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/urls.adoc[] +:chapters-path: content/{{% lang %}}/books/developers-handbook/ +endif::[] +ifdef::backend-pdf,backend-epub3[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] +endif::[] + +ifndef::env-beastie[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] + +[.abstract-title] +[abstract] +摘要 + +歡迎使用 Developers' Handbook！ 這份文件是由許多人 _不斷撰寫_ 而成的， 而且許多章節仍需更新或者內容還是一片空白， 如果你想幫忙 FreeBSD 文件計劃， 請寄信到 {freebsd-doc}。 + +最新版的文件都在 link:https://www.FreeBSD.org[FreeBSD 官網] 上面， 也可從 link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[FreeBSD FTP server] 下載不同格式的資料。 當然也可以在其他的 extref:{handbook}mirrors/[mirror站, mirrors-ftp]下載。 + +''' + +toc::[] + +// Section one +include::{chapters-path}parti.adoc[lines=15..16] +include::{chapters-path}introduction/_index.adoc[leveloffset=+1] +include::{chapters-path}tools/_index.adoc[leveloffset=+1] +include::{chapters-path}secure/_index.adoc[leveloffset=+1] +include::{chapters-path}l10n/_index.adoc[leveloffset=+1] +include::{chapters-path}policies/_index.adoc[leveloffset=+1] +include::{chapters-path}testing/_index.adoc[leveloffset=+1] + +// Section two +include::{chapters-path}partii.adoc[lines=15..16] +include::{chapters-path}sockets/_index.adoc[leveloffset=+1] +include::{chapters-path}ipv6/_index.adoc[leveloffset=+1] + +// Section three +include::{chapters-path}partiii.adoc[lines=15..16] +include::{chapters-path}kernelbuild/_index.adoc[leveloffset=+1] +include::{chapters-path}kerneldebug/_index.adoc[leveloffset=+1] + +// Section four +include::{chapters-path}partiv.adoc[lines=15..16] +include::{chapters-path}x86/_index.adoc[leveloffset=+1] + +// Appendices +include::{chapters-path}partv.adoc[lines=15..16] +include::{chapters-path}bibliography/_index.adoc[leveloffset=+1] diff --git a/documentation/content/zh-tw/books/developers-handbook/chapters-order.adoc b/documentation/content/zh-tw/books/developers-handbook/chapters-order.adoc index 90183764d6..ef978f645c 100644 --- a/documentation/content/zh-tw/books/developers-handbook/chapters-order.adoc +++ b/documentation/content/zh-tw/books/developers-handbook/chapters-order.adoc @@ -1,12 +1,17 @@ -introduction/chapter.adoc -tools/chapter.adoc -secure/chapter.adoc -l10n/chapter.adoc -policies/chapter.adoc -testing/chapter.adoc -sockets/chapter.adoc -ipv6/chapter.adoc -kernelbuild/chapter.adoc -kerneldebug/chapter.adoc -x86/chapter.adoc -bibliography/chapter.adoc +parti.adoc +introduction/_index.adoc +tools/_index.adoc +secure/_index.adoc +l10n/_index.adoc +policies/_index.adoc +testing/_index.adoc +partii.adoc +sockets/_index.adoc +ipv6/_index.adoc +partiii.adoc +kernelbuild/_index.adoc +kerneldebug/_index.adoc +partiv.adoc +x86/_index.adoc +partv.adoc +bibliography/_index.adoc diff --git a/documentation/content/zh-tw/books/developers-handbook/introduction/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/introduction/_index.adoc similarity index 99% rename from documentation/content/zh-tw/books/developers-handbook/introduction/chapter.adoc rename to documentation/content/zh-tw/books/developers-handbook/introduction/_index.adoc index 61ee4970a5..73cf9fac07 100644 --- a/documentation/content/zh-tw/books/developers-handbook/introduction/chapter.adoc +++ b/documentation/content/zh-tw/books/developers-handbook/introduction/_index.adoc @@ -3,7 +3,7 @@ title: 章 1. 簡介 authors: - author: Murray Stokely - author: Jeroen Ruigrok van der Werven -prev: books/developers-handbook/ +prev: books/developers-handbook/parti next: books/developers-handbook/tools --- diff --git a/documentation/content/zh-tw/books/developers-handbook/ipv6/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/ipv6/_index.adoc similarity index 99% rename from documentation/content/zh-tw/books/developers-handbook/ipv6/chapter.adoc rename to documentation/content/zh-tw/books/developers-handbook/ipv6/_index.adoc index 5cf1433a1e..8e5b5882f2 100644 --- a/documentation/content/zh-tw/books/developers-handbook/ipv6/chapter.adoc +++ b/documentation/content/zh-tw/books/developers-handbook/ipv6/_index.adoc @@ -3,7 +3,7 @@ title: 章 8. IPv6 Internals authors: - author: Yoshinobu Inoue prev: books/developers-handbook/sockets -next: books/developers-handbook/kernelbuild +next: books/developers-handbook/partiii --- [[ipv6]] diff --git a/documentation/content/zh-tw/books/developers-handbook/kernelbuild/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/kernelbuild/_index.adoc similarity index 98% rename from documentation/content/zh-tw/books/developers-handbook/kernelbuild/chapter.adoc rename to documentation/content/zh-tw/books/developers-handbook/kernelbuild/_index.adoc index 0c4a4c4153..da8a124490 100644 --- a/documentation/content/zh-tw/books/developers-handbook/kernelbuild/chapter.adoc +++ b/documentation/content/zh-tw/books/developers-handbook/kernelbuild/_index.adoc @@ -1,6 +1,6 @@ --- title: 章 9. Building and Installing a FreeBSD Kernel -prev: books/developers-handbook/ipv6 +prev: books/developers-handbook/partiii next: books/developers-handbook/kerneldebug --- diff --git a/documentation/content/zh-tw/books/developers-handbook/kerneldebug/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/kerneldebug/_index.adoc similarity index 99% rename from documentation/content/zh-tw/books/developers-handbook/kerneldebug/chapter.adoc rename to documentation/content/zh-tw/books/developers-handbook/kerneldebug/_index.adoc index 50b8de3416..71b0e6b7ed 100644 --- a/documentation/content/zh-tw/books/developers-handbook/kerneldebug/chapter.adoc +++ b/documentation/content/zh-tw/books/developers-handbook/kerneldebug/_index.adoc @@ -5,7 +5,7 @@ authors: - author: Jörg Wunsch - author: Robert Watson prev: books/developers-handbook/kernelbuild -next: books/developers-handbook/x86 +next: books/developers-handbook/partiv --- [[kerneldebug]] diff --git a/documentation/content/zh-tw/books/developers-handbook/l10n/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/l10n/_index.adoc similarity index 100% rename from documentation/content/zh-tw/books/developers-handbook/l10n/chapter.adoc rename to documentation/content/zh-tw/books/developers-handbook/l10n/_index.adoc diff --git a/documentation/content/zh-tw/books/developers-handbook/parti.adoc b/documentation/content/zh-tw/books/developers-handbook/parti.adoc new file mode 100644 index 0000000000..74cb4ce52b --- /dev/null +++ b/documentation/content/zh-tw/books/developers-handbook/parti.adoc @@ -0,0 +1,18 @@ +--- +title: Part I. Grundlagen +prev: books/developers-handbook +next: books/developers-handbook/introduction +--- + +ifdef::env-beastie+backend-html5[] +:chapters-path: content/{{% lang %}}/books/developers-handbook/ +endif::[] + +ifndef::env-beastie[] +:chapters-path: +endif::[] + +[[basics]] += 基本概念 + +include::{chapters-path}toc-1.adoc[] diff --git a/documentation/content/zh-tw/books/developers-handbook/partii.adoc b/documentation/content/zh-tw/books/developers-handbook/partii.adoc new file mode 100644 index 0000000000..b00d77ce88 --- /dev/null +++ b/documentation/content/zh-tw/books/developers-handbook/partii.adoc @@ -0,0 +1,18 @@ +--- +title: Part II. Interprozess-Kommunikation +prev: books/developers-handbook/testing +next: books/developers-handbook/sockets +--- + +ifdef::env-beastie+backend-html5[] +:chapters-path: content/{{% lang %}}/books/developers-handbook/ +endif::[] + +ifndef::env-beastie[] +:chapters-path: +endif::[] + +[[ipc]] += Interprocess Communication(IPC) + +include::{chapters-path}toc-2.adoc[] diff --git a/documentation/content/zh-tw/books/developers-handbook/partiii.adoc b/documentation/content/zh-tw/books/developers-handbook/partiii.adoc new file mode 100644 index 0000000000..72492990ca --- /dev/null +++ b/documentation/content/zh-tw/books/developers-handbook/partiii.adoc @@ -0,0 +1,18 @@ +--- +title: Part III. Kernel +prev: books/developers-handbook/ipv6 +next: books/developers-handbook/kernelbuild +--- + +ifdef::env-beastie+backend-html5[] +:chapters-path: content/{{% lang %}}/books/developers-handbook/ +endif::[] + +ifndef::env-beastie[] +:chapters-path: +endif::[] + +[[kernel]] += Kernel(核心) + +include::{chapters-path}toc-3.adoc[] diff --git a/documentation/content/zh-tw/books/developers-handbook/partiv.adoc b/documentation/content/zh-tw/books/developers-handbook/partiv.adoc new file mode 100644 index 0000000000..495e233fb0 --- /dev/null +++ b/documentation/content/zh-tw/books/developers-handbook/partiv.adoc @@ -0,0 +1,19 @@ +--- +title: Part IV. Architekturen +prev: books/developers-handbook/kerneldebug +next: books/developers-handbook/x86 +--- + +ifdef::env-beastie+backend-html5[] +:chapters-path: content/{{% lang %}}/books/developers-handbook/ +endif::[] + +ifndef::env-beastie[] +:chapters-path: +endif::[] + +[[architectures]] += Architectures(電腦架構) + +include::{chapters-path}toc-4.adoc[] + diff --git a/documentation/content/zh-tw/books/developers-handbook/partv.adoc b/documentation/content/zh-tw/books/developers-handbook/partv.adoc new file mode 100644 index 0000000000..aad1558580 --- /dev/null +++ b/documentation/content/zh-tw/books/developers-handbook/partv.adoc @@ -0,0 +1,18 @@ +--- +title: Part V. Appendices +prev: books/developers-handbook/x86 +next: books/developers-handbook/bibliography +--- + +ifdef::env-beastie+backend-html5[] +:chapters-path: content/{{% lang %}}/books/developers-handbook/ +endif::[] + +ifndef::env-beastie[] +:chapters-path: +endif::[] + +[[appendices]] += Appendices + +include::{chapters-path}toc-5.adoc[] diff --git a/documentation/content/zh-tw/books/developers-handbook/policies/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/policies/_index.adoc similarity index 100% rename from documentation/content/zh-tw/books/developers-handbook/policies/chapter.adoc rename to documentation/content/zh-tw/books/developers-handbook/policies/_index.adoc diff --git a/documentation/content/zh-tw/books/developers-handbook/secure/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/secure/_index.adoc similarity index 94% rename from documentation/content/zh-tw/books/developers-handbook/secure/chapter.adoc rename to documentation/content/zh-tw/books/developers-handbook/secure/_index.adoc index ec5a9cc4f5..998dca0993 100644 --- a/documentation/content/zh-tw/books/developers-handbook/secure/chapter.adoc +++ b/documentation/content/zh-tw/books/developers-handbook/secure/_index.adoc @@ -59,9 +59,9 @@ One of the pitfalls of the UNIX(R) environment is how easy it is to make assumpt [[secure-bufferov]] == Buffer Overflows -Buffer Overflows have been around since the very beginnings of the von Neumann <> architecture. They first gained widespread notoriety in 1988 with the Morris Internet worm. Unfortunately, the same basic attack remains effective today. By far the most common type of buffer overflow attack is based on corrupting the stack. +Buffer Overflows have been around since the very beginnings of the von Neumann crossref:bibliography[COD,1] architecture. They first gained widespread notoriety in 1988 with the Morris Internet worm. Unfortunately, the same basic attack remains effective today. By far the most common type of buffer overflow attack is based on corrupting the stack. -Most modern computer systems use a stack to pass arguments to procedures and to store local variables. A stack is a last in first out (LIFO) buffer in the high memory area of a process image. When a program invokes a function a new "stack frame" is created. This stack frame consists of the arguments passed to the function as well as a dynamic amount of local variable space. The "stack pointer" is a register that holds the current location of the top of the stack. Since this value is constantly changing as new values are pushed onto the top of the stack, many implementations also provide a "frame pointer" that is located near the beginning of a stack frame so that local variables can more easily be addressed relative to this value. <> The return address for function calls is also stored on the stack, and this is the cause of stack-overflow exploits since overflowing a local variable in a function can overwrite the return address of that function, potentially allowing a malici ous user to execute any code he or she wants. +Most modern computer systems use a stack to pass arguments to procedures and to store local variables. A stack is a last in first out (LIFO) buffer in the high memory area of a process image. When a program invokes a function a new "stack frame" is created. This stack frame consists of the arguments passed to the function as well as a dynamic amount of local variable space. The "stack pointer" is a register that holds the current location of the top of the stack. Since this value is constantly changing as new values are pushed onto the top of the stack, many implementations also provide a "frame pointer" that is located near the beginning of a stack frame so that local variables can more easily be addressed relative to this value. crossref:bibliography[COD,1] The return address for function calls is also stored on the stack, and this is the cause of stack-overflow exploits since overflowing a local variable in a function can overwrite the return address of that function, potentia lly allowing a malicious user to execute any code he or she wants. Although stack-based attacks are by far the most common, it would also be possible to overrun the stack with a heap-based (malloc/free) attack. @@ -109,7 +109,7 @@ May overflow the str buffer. === Example Buffer Overflow -The following example code contains a buffer overflow designed to overwrite the return address and skip the instruction immediately following the function call. (Inspired by <>) +The following example code contains a buffer overflow designed to overwrite the return address and skip the instruction immediately following the function call. (Inspired by crossref:bibliography[Phrack,4]) [.programlisting] .... diff --git a/documentation/content/zh-tw/books/developers-handbook/sockets/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/sockets/_index.adoc similarity index 99% rename from documentation/content/zh-tw/books/developers-handbook/sockets/chapter.adoc rename to documentation/content/zh-tw/books/developers-handbook/sockets/_index.adoc index db0b2db27e..952233ffeb 100644 --- a/documentation/content/zh-tw/books/developers-handbook/sockets/chapter.adoc +++ b/documentation/content/zh-tw/books/developers-handbook/sockets/_index.adoc @@ -2,7 +2,7 @@ title: 章 7. Sockets authors: - author: G. Adam Stanislav -prev: books/developers-handbook/testing +prev: books/developers-handbook/partii next: books/developers-handbook/ipv6 --- diff --git a/documentation/content/zh-tw/books/developers-handbook/testing/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/testing/_index.adoc similarity index 99% rename from documentation/content/zh-tw/books/developers-handbook/testing/chapter.adoc rename to documentation/content/zh-tw/books/developers-handbook/testing/_index.adoc index 7bf62f89e2..503c241da6 100644 --- a/documentation/content/zh-tw/books/developers-handbook/testing/chapter.adoc +++ b/documentation/content/zh-tw/books/developers-handbook/testing/_index.adoc @@ -1,7 +1,7 @@ --- title: 章 6. Regression and Performance Testing prev: books/developers-handbook/policies -next: books/developers-handbook/sockets +next: books/developers-handbook/partii --- [[testing]] diff --git a/documentation/content/zh-tw/books/developers-handbook/tools/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/tools/_index.adoc similarity index 99% rename from documentation/content/zh-tw/books/developers-handbook/tools/chapter.adoc rename to documentation/content/zh-tw/books/developers-handbook/tools/_index.adoc index fe6852d1d0..502a5ca091 100644 --- a/documentation/content/zh-tw/books/developers-handbook/tools/chapter.adoc +++ b/documentation/content/zh-tw/books/developers-handbook/tools/_index.adoc @@ -623,7 +623,7 @@ to the file. Once you have done this, you can type `info` and then select [.guim Using a debugger allows running the program under more controlled circumstances. Typically, it is possible to step through the program a line at a time, inspect the value of variables, change them, tell the debugger to run up to a certain point and then stop, and so on. It is also possible to attach to a program that is already running, or load a core file to investigate why the program crashed. It is even possible to debug the kernel, though that is a little trickier than the user applications we will be discussing in this section. -This section is intended to be a quick introduction to using debuggers and does not cover specialized topics such as debugging the kernel. For more information about that, refer to <>. +This section is intended to be a quick introduction to using debuggers and does not cover specialized topics such as debugging the kernel. For more information about that, refer to crossref:kerneldebug[kerneldebug,Kernel Debugging]. The standard debugger supplied with FreeBSD {rel121-current} is called `lldb` (LLVM debugger). As it is part of the standard installation for that release, there is no need to do anything special to use it. It has good command help, accessible via the `help` command, as well as https://lldb.llvm.org/[a web tutorial and documentation]. diff --git a/documentation/content/zh-tw/books/developers-handbook/x86/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/x86/_index.adoc similarity index 99% rename from documentation/content/zh-tw/books/developers-handbook/x86/chapter.adoc rename to documentation/content/zh-tw/books/developers-handbook/x86/_index.adoc index fa49e3d364..599380f57d 100644 --- a/documentation/content/zh-tw/books/developers-handbook/x86/chapter.adoc +++ b/documentation/content/zh-tw/books/developers-handbook/x86/_index.adoc @@ -1,7 +1,7 @@ --- title: 章 11. x86 Assembly Language Programming -prev: books/developers-handbook/kerneldebug -next: books/developers-handbook/bibliography +prev: books/developers-handbook/partiv +next: books/developers-handbook/partv --- [[x86]] From nobody Sun Nov 21 21:08:15 2021 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 D2F4D18ACE30 for ; Sun, 21 Nov 2021 21:08:15 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Hy30H5Ysxz3m6g; Sun, 21 Nov 2021 21:08:15 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 9B704162FC; Sun, 21 Nov 2021 21:08:15 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1ALL8FD1001694; Sun, 21 Nov 2021 21:08:15 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1ALL8FHA001693; Sun, 21 Nov 2021 21:08:15 GMT (envelope-from git) Date: Sun, 21 Nov 2021 21:08:15 GMT Message-Id: <202111212108.1ALL8FHA001693@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 48e3628160 - main - Ignore .hugo_build.lock in .gitignore for documentation and website 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 48e36281609947030df00b469d7313b33bd6c7be Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=48e36281609947030df00b469d7313b33bd6c7be commit 48e36281609947030df00b469d7313b33bd6c7be Author: Minsoo Choo AuthorDate: 2021-11-21 21:07:21 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-11-21 21:07:21 +0000 Ignore .hugo_build.lock in .gitignore for documentation and website Approved by: carlavilla@ Differential Revision: https://reviews.freebsd.org/D33072 --- documentation/.gitignore | 3 +++ documentation/.hugo_build.lock | 0 website/.gitignore | 3 +++ 3 files changed, 6 insertions(+) diff --git a/documentation/.gitignore b/documentation/.gitignore index a0241913a9..14fbc4731d 100644 --- a/documentation/.gitignore +++ b/documentation/.gitignore @@ -15,3 +15,6 @@ toc-5.adoc pgpkeys.txt *.swp + +# .hugo_build.lock is an empty file for building hugo projects. +.hugo_build.lock diff --git a/documentation/.hugo_build.lock b/documentation/.hugo_build.lock deleted file mode 100644 index e69de29bb2..0000000000 diff --git a/website/.gitignore b/website/.gitignore index 0bba3cc84e..93f22b74fb 100644 --- a/website/.gitignore +++ b/website/.gitignore @@ -6,3 +6,6 @@ resources /data/releases.toml *.swp + +# .hugo_build.lock is an empty file for building hugo projects. +.hugo_build.lock From nobody Mon Nov 22 17:52:24 2021 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 585B7188E180 for ; Mon, 22 Nov 2021 17:52:25 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HyZbs1lrNz4nwG; Mon, 22 Nov 2021 17:52:25 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id EF1C727322; Mon, 22 Nov 2021 17:52:24 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AMHqOwW070474; Mon, 22 Nov 2021 17:52:24 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AMHqOKH070473; Mon, 22 Nov 2021 17:52:24 GMT (envelope-from git) Date: Mon, 22 Nov 2021 17:52:24 GMT Message-Id: <202111221752.1AMHqOKH070473@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ed Maste Subject: git: d7870ca5a1 - main - handbook: 11.4 is EOL - remove it from the introduction 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: emaste X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: d7870ca5a138c0ef3e587b1e5f9bb41f7b11548c Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by emaste: URL: https://cgit.FreeBSD.org/doc/commit/?id=d7870ca5a138c0ef3e587b1e5f9bb41f7b11548c commit d7870ca5a138c0ef3e587b1e5f9bb41f7b11548c Author: Ed Maste AuthorDate: 2021-11-22 17:33:55 +0000 Commit: Ed Maste CommitDate: 2021-11-22 17:51:32 +0000 handbook: 11.4 is EOL - remove it from the introduction Approved by: ygy (mentor) Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D33080 --- documentation/content/en/books/handbook/_index.adoc | 2 +- documentation/content/en/books/handbook/book.adoc | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/books/handbook/_index.adoc b/documentation/content/en/books/handbook/_index.adoc index 00b814f978..47946ca6c4 100644 --- a/documentation/content/en/books/handbook/_index.adoc +++ b/documentation/content/en/books/handbook/_index.adoc @@ -49,7 +49,7 @@ endif::[] [.abstract-title] Abstract -Welcome to FreeBSD! This handbook covers the installation and day to day use of _FreeBSD {rel130-current}-RELEASE_, _FreeBSD {rel122-current}-RELEASE_ and _FreeBSD {rel114-current}-RELEASE_. +Welcome to FreeBSD! This handbook covers the installation and day to day use of _FreeBSD {rel130-current}-RELEASE_ and _FreeBSD {rel122-current}-RELEASE_. This book is the result of ongoing work by many individuals. Some sections might be outdated. Those interested in helping to update and expand this document should send email to the {freebsd-doc}. diff --git a/documentation/content/en/books/handbook/book.adoc b/documentation/content/en/books/handbook/book.adoc index 6facc0e7dd..5304fe1939 100644 --- a/documentation/content/en/books/handbook/book.adoc +++ b/documentation/content/en/books/handbook/book.adoc @@ -48,7 +48,7 @@ endif::[] [.abstract-title] Abstract -Welcome to FreeBSD! This handbook covers the installation and day to day use of _FreeBSD {rel122-current}-RELEASE_, _FreeBSD {rel121-current}-RELEASE_ and _FreeBSD {rel114-current}-RELEASE_. +Welcome to FreeBSD! This handbook covers the installation and day to day use of _FreeBSD {rel122-current}-RELEASE_ and _FreeBSD {rel121-current}-RELEASE_. This book is the result of ongoing work by many individuals. Some sections might be outdated. Those interested in helping to update and expand this document should send email to the {freebsd-doc}. From nobody Mon Nov 22 18:53:37 2021 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 AF4E4188D13D for ; Mon, 22 Nov 2021 18:53:37 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HybyT4QS5z3qWg; Mon, 22 Nov 2021 18:53:37 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 7771289; Mon, 22 Nov 2021 18:53:37 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AMIrbVX051618; Mon, 22 Nov 2021 18:53:37 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AMIrbeV051617; Mon, 22 Nov 2021 18:53:37 GMT (envelope-from git) Date: Mon, 22 Nov 2021 18:53:37 GMT Message-Id: <202111221853.1AMIrbeV051617@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ed Maste Subject: git: c2c63155b2 - main - faq: remove reference to 11.X as it is EOL 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: emaste X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c2c63155b2e220d63a4ae40947629539adb9355d Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by emaste: URL: https://cgit.FreeBSD.org/doc/commit/?id=c2c63155b2e220d63a4ae40947629539adb9355d commit c2c63155b2e220d63a4ae40947629539adb9355d Author: Ed Maste AuthorDate: 2021-11-22 18:44:24 +0000 Commit: Ed Maste CommitDate: 2021-11-22 18:52:42 +0000 faq: remove reference to 11.X as it is EOL Reported by: Pau Amma Approved by: ygy (mentor) Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D33082 --- documentation/content/en/books/faq/_index.adoc | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/documentation/content/en/books/faq/_index.adoc b/documentation/content/en/books/faq/_index.adoc index a0583bdf8f..f8c4571758 100644 --- a/documentation/content/en/books/faq/_index.adoc +++ b/documentation/content/en/books/faq/_index.adoc @@ -1,5 +1,5 @@ --- -title: Frequently Asked Questions for FreeBSD 11.X, 12.X, and 13.X +title: Frequently Asked Questions for FreeBSD 12.X and 13.X authors: - author: The FreeBSD Documentation Project copyright: 1995-2021 The FreeBSD Documentation Project @@ -33,10 +33,6 @@ isIndex: true :rel2-stable: 12-STABLE :rel2-releng: stable/12/ :rel2-relengdate: December 2018 -:rel3-relx: 11.X -:rel3-stable: 11-STABLE -:rel3-releng: stable/11/ -:rel3-relengdate: October 2016 ifdef::env-beastie[] ifdef::backend-html5[] @@ -60,7 +56,7 @@ endif::[] [.abstract-title] Abstract -This is the Frequently Asked Questions (FAQ) for FreeBSD versions {rel-relx}, {rel2-relx}, and {rel3-relx}. +This is the Frequently Asked Questions (FAQ) for FreeBSD versions {rel-relx} and {rel2-relx}. Every effort has been made to make this FAQ as informative as possible; if you have any suggestions as to how it may be improved, send them to the {freebsd-doc}. The latest version of this document is always available from the extref:{faq}[FreeBSD website]. From nobody Mon Nov 22 19:16:30 2021 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 BFE8E18980EB for ; Mon, 22 Nov 2021 19:16:30 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HycSt5048z4RZM; Mon, 22 Nov 2021 19:16:30 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 8B1D1603; Mon, 22 Nov 2021 19:16:30 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AMJGURa079310; Mon, 22 Nov 2021 19:16:30 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AMJGUbN079309; Mon, 22 Nov 2021 19:16:30 GMT (envelope-from git) Date: Mon, 22 Nov 2021 19:16:30 GMT Message-Id: <202111221916.1AMJGUbN079309@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ed Maste Subject: git: a480c4acdc - main - handbook: correct supported releases 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: emaste X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: a480c4acdca195f7c58923675cfe3d854195cfa0 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by emaste: URL: https://cgit.FreeBSD.org/doc/commit/?id=a480c4acdca195f7c58923675cfe3d854195cfa0 commit a480c4acdca195f7c58923675cfe3d854195cfa0 Author: Ed Maste AuthorDate: 2021-11-22 18:40:38 +0000 Commit: Ed Maste CommitDate: 2021-11-22 19:15:33 +0000 handbook: correct supported releases Should be 13.0 and 12.2, not 12.2 and 12.1. _index.adoc was correct but not book.adoc. Reported by: Pau Amma Approved by: ygy (mentor) Sponsored by: The FreeBSD Foundation --- documentation/content/en/books/handbook/book.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/books/handbook/book.adoc b/documentation/content/en/books/handbook/book.adoc index 5304fe1939..97d270a8b0 100644 --- a/documentation/content/en/books/handbook/book.adoc +++ b/documentation/content/en/books/handbook/book.adoc @@ -48,7 +48,7 @@ endif::[] [.abstract-title] Abstract -Welcome to FreeBSD! This handbook covers the installation and day to day use of _FreeBSD {rel122-current}-RELEASE_ and _FreeBSD {rel121-current}-RELEASE_. +Welcome to FreeBSD! This handbook covers the installation and day to day use of _FreeBSD {rel130-current}-RELEASE_ and _FreeBSD {rel122-current}-RELEASE_. This book is the result of ongoing work by many individuals. Some sections might be outdated. Those interested in helping to update and expand this document should send email to the {freebsd-doc}. From nobody Tue Nov 23 15:47:39 2021 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 3F6A4189E7AD for ; Tue, 23 Nov 2021 15:47:40 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Hz7nR6tF9z3GRl; Tue, 23 Nov 2021 15:47:39 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id C7E2918E71; Tue, 23 Nov 2021 15:47:39 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1ANFld4d033669; Tue, 23 Nov 2021 15:47:39 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1ANFldTj033668; Tue, 23 Nov 2021 15:47:39 GMT (envelope-from git) Date: Tue, 23 Nov 2021 15:47:39 GMT Message-Id: <202111231547.1ANFldTj033668@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?Q?Fernando Apestegu=C3=ADa?= Subject: git: 4cb82fb538 - main - [doc-es] articles/building-products: sync with master 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 4cb82fb5381c88e66bd41efafec4e7b9514c8397 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1637682460; 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; bh=2Nomlj7AYYxo9uy+MZZYjhXoa3dQxEJEpWqJmu/np54=; b=mhMlJnGH9RDgWy7lm5tVaWiZQ1ZAEZtklMe9lhachUHhWkkMJsWzy8jJAdmkTUnE5TGLTo SCsqHDe07zIVh1YxQO55ENKmElRgnmuvFPEPQx7hJ12M3oo8mBV4z9cN/QfltZHKC8ZJg2 u5QMXm+t3TP+EaApZG+kjBpo7dAA1VLIekqlrEq0gCUf0FjNH61cw/0rNOLgV0Ji3evQ9F 8b5YrsK2Em/wccKiJ1/sDdKfT27V/C5HoAf4e3DK3+gy9pzo/Sh5lbYOmhFIHoJkJIf9mD 3eG7n1G3CwbNZKI/cQKZ5c3Mxz64fsFV0c/yBYjNvpCx9eZk0PgL4rqXB2h5BQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1637682460; a=rsa-sha256; cv=none; b=lKGpzh6pDIG2pMkMclHLuv4C3SKDGo2rNDTxUyiQA563QGUNU5omptyEY+sqfPFHikKWiy K5lRiwbboDJTE6b/8qeqG0186QwqSer1V35ZEiMXO/VdX1rw6WOR0hQOY3LA6QJYGS89oA x9NzvMiXu9I2k8VdizoNUB4kSRk/Yri3geXPKNHUJ0CXP2XJXXhYxpIGfyy2VmK2Rv2dCK 5XkhaW3oVsVVa95ZDEcsmGx7Zq8ZQbuNBNzV4ZXxAFaO3iQnuaTVvhbvcMvGUzobagr3yO ug7MqMCz0tE0Mm3np008JTH+dcFf+dXJJIEY/LeNSWLzWAyraA/wf0jPDdl3UA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=4cb82fb5381c88e66bd41efafec4e7b9514c8397 commit 4cb82fb5381c88e66bd41efafec4e7b9514c8397 Author: Fernando Apesteguía AuthorDate: 2021-11-23 15:45:49 +0000 Commit: Fernando Apesteguía CommitDate: 2021-11-23 15:45:49 +0000 [doc-es] articles/building-products: sync with master --- .../es/articles/building-products/_index.adoc | 8 +- .../es/articles/building-products/_index.po | 483 ++++++++++----------- 2 files changed, 231 insertions(+), 260 deletions(-) diff --git a/documentation/content/es/articles/building-products/_index.adoc b/documentation/content/es/articles/building-products/_index.adoc index ae6e3b3928..dcef2b56b7 100644 --- a/documentation/content/es/articles/building-products/_index.adoc +++ b/documentation/content/es/articles/building-products/_index.adoc @@ -179,7 +179,7 @@ image::freebsd-branches.png[] Las líneas de código se mantienen vivas mientras haya interés en ellas por parte del usuario y del desarrollador. -Las arquitecturas se agrupan en "tiers"; Las arquitecturas _Tier 1_ están soportadas por completo por los equipos de seguridad y de ingeniería de versiones del proyecto, las arquitecturas _Tier 2_ están soportadas lo mejor posible y _Tier 3_ está compuesto de arquitecturas experimentales. La lista de extref:{committers-guide}[arquitecturas soportadas, archs] es parte de la colección de documentación de FreeBSD. +Las arquitecturas se agrupan en "tiers"; Las arquitecturas _Tier 1_ están soportadas por completo por los equipos de seguridad y de ingeniería de versiones del proyecto, las arquitecturas _Tier 2_ están soportadas lo mejor posible y _Tier 3_ está compuesto de arquitecturas experimentales. La lista de extref:{committers-guide}[arquitecturas soportadas,archs] es parte de la colección de documentación de FreeBSD. El equipo de ingeniería de versiones publica una link:https://www.FreeBSD.org/releng/[hoja de ruta] para futuras versiones de FreeBSD en el sitio web del proyecto. Las fechas que hay en la hoja de ruta no son fechas límite; FreeBSD se libera cuando el código y la documentación están listos. @@ -198,7 +198,7 @@ Mientras que el acceso al código fuente de calidad puede reducir el coste del d ** Desarrollar un sistema operativo de alta calidad para los equipos informáticos más utilizados, y, ** Poner nuestro trabajo a disposición de todos bajo una licencia liberal. -* FreeBSD disfruta de una cultura de trabajo abierta y transparente. Prácticamente toda la discusión en el proyecto se produce por email, en https://lists.freebsd.org/mailman/listinfo[listas públicas de correo] que son archivadas para la posteridad. Las políticas del proyecto están link:https://www.FreeBSD.org/internal/policies/[documentadas] y mantenidas bajo control de versiones. La participación en el proyecto está abierta a cualquiera. +* FreeBSD disfruta de una cultura de trabajo abierta y transparente. Prácticamente toda la discusión en el proyecto se produce por email, en link:https://lists.freebsd.org/[listas públicas de correo] que son archivadas para la posteridad. Las políticas del proyecto están link:https://www.FreeBSD.org/internal/policies/[documentadas] y mantenidas bajo control de versiones. La participación en el proyecto está abierta a cualquiera. [[freebsd-org]] === Comprendiendo la cultura de FreeBSD @@ -251,7 +251,7 @@ A continuación presentamos algunas de las mejores prácticas para hacer el mejo Planificar a largo plazo:: Establecer procesos que ayuden a hacer el seguimiento del desarrollo de FreeBSD. Por ejemplo: + -*Seguimiento del código fuente de FreeBSD.* El proyecto hace sencillo clonar su repositorio SVN utilizando extref:{committers-guide}[svnsync, svn-advanced-use-setting-up-svnsync]. Tener el histórico completo de las fuentes es útil cuando se depuran problemas complejos y ofrece un conocimiento valioso de las intenciones de los desarrolladores originales. Utiliza un sistema de control de código capaz que te permita incorporar cambios entre el código base de FreeBSD y tu propio código. +*Seguimiento del código fuente de FreeBSD.* El proyecto hace sencillo clonar su repositorio SVN utilizando extref:{committers-guide}[svnsync,svn-advanced-use-setting-up-svnsync]. Tener el histórico completo de las fuentes es útil cuando se depuran problemas complejos y ofrece un conocimiento valioso de las intenciones de los desarrolladores originales. Utiliza un sistema de control de código capaz que te permita incorporar cambios entre el código base de FreeBSD y tu propio código. + <> muestra una porción de un listado anotado del fichero referenciado por el registro de cambio en >. El antecesor de cada línea es claramente visible. Los listados anotados que muestran el histórico de cada fichero que forma parte de FreeBSD están https://svnweb.freebsd.org/[disponibles en la web]. + @@ -288,7 +288,7 @@ Una parte importante de los costes asociados al desarrollo de productos es el ma Obtén apoyo de manera efectiva:: Para productos con fechas límite ajustadas, se recomienda que contrates o realices un acuerdo de consultoría con un desarrollador o empresa con experiencia en FreeBSD. {freebsd-jobs} es un canal de comunicación útil para encontrar talento. El proyecto FreeBSD mantiene una link:https://www.FreeBSD.org/commercial/consult_bycat/[galería de consultores y empresas de consultoría] que realizan trabajo sobre FreeBSD. El http://www.bsdcertification.org/[BSD Certification Group] ofrece certificaciones para todos los sistemas operativos importantes derivados de BSD. + -Para necesidades menos críticas, puedes solicitar ayuda en las http://lists.FreeBSD.org/mailman/listinfo[listas de correo del proyecto]. Una guía útil para seguir cuando se solicita ayuda es <>. +Para necesidades menos críticas, puedes solicitar ayuda en las link:https://lists.freebsd.org/[listas de correo del proyecto]. Una guía útil para seguir cuando se solicita ayuda es <>. Publicita tu participación:: No es necesario que publicites tu uso de FreeBSD, pero hacerlo ayuda tanto a tu esfuerzo como al del proyecto. + diff --git a/documentation/content/es/articles/building-products/_index.po b/documentation/content/es/articles/building-products/_index.po index 5c8f833d09..5b26bd04c9 100644 --- a/documentation/content/es/articles/building-products/_index.po +++ b/documentation/content/es/articles/building-products/_index.po @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2021-06-08 07:32-0300\n" -"PO-Revision-Date: 2021-10-01 15:26+0000\n" +"POT-Creation-Date: 2021-11-23 16:36+0100\n" +"PO-Revision-Date: 2021-11-23 15:30+0000\n" "Last-Translator: Fernando Apesteguía \n" "Language-Team: Spanish \n" @@ -15,7 +15,7 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=n != 1;\n" -"X-Generator: Weblate 4.8\n" +"X-Generator: Weblate 4.8.1\n" #. type: YAML Front Matter: description #: documentation/content/en/articles/building-products/_index.adoc:1 @@ -31,12 +31,23 @@ msgid "Building Products with FreeBSD" msgstr "Construyendo productos con FreeBSD" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:47 +#: documentation/content/en/articles/building-products/_index.adoc:33 +msgid "" +"include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/" +"{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists.adoc[] " +"include::shared/{{% lang %}}/urls.adoc[]" +msgstr "" +"include::shared/attributes/attributes-{{% lang %}}.adoc[] include::shared/" +"{{% lang %}}/teams.adoc[] include::shared/{{% lang %}}/mailing-lists.adoc[] " +"include::shared/{{% lang %}}/urls.adoc[]" + +#. type: Plain text +#: documentation/content/en/articles/building-products/_index.adoc:46 msgid "Abstract" msgstr "Resumen" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:51 +#: documentation/content/en/articles/building-products/_index.adoc:50 msgid "" "The FreeBSD project is a worldwide, volunteer based, and collaborative " "project, which develops a portable and high-quality operating system. The " @@ -54,7 +65,7 @@ msgstr "" "mejorar la calidad de sus productos." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:55 +#: documentation/content/en/articles/building-products/_index.adoc:54 msgid "" "This article examines the issues in using FreeBSD code in appliances and " "software products. It highlights the characteristics of FreeBSD that make " @@ -69,18 +80,18 @@ msgstr "" "organizaciones que colaboran con el proyecto FreeBSD." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:57 +#: documentation/content/en/articles/building-products/_index.adoc:56 msgid "'''" msgstr "'''" #. type: Title == -#: documentation/content/en/articles/building-products/_index.adoc:61 +#: documentation/content/en/articles/building-products/_index.adoc:60 #, no-wrap msgid "Introduction" msgstr "Introducción" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:67 +#: documentation/content/en/articles/building-products/_index.adoc:66 msgid "" "FreeBSD today is well-known as a high-performance server operating system. " "It is deployed on millions of web servers and internet-facing hosts " @@ -98,7 +109,7 @@ msgstr "" "(ver <>)." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:69 +#: documentation/content/en/articles/building-products/_index.adoc:68 msgid "" "In this article we look at the link:https://www.FreeBSD.org/[FreeBSD " "project] as a software engineering resource-as a collection of building " @@ -109,7 +120,7 @@ msgstr "" "construcción y procesos que puedes usar para construir tu producto." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:72 +#: documentation/content/en/articles/building-products/_index.adoc:71 msgid "" "While FreeBSD's source is distributed freely to the public, to fully enjoy " "the benefits of the project's work, organizations need to _collaborate_ with " @@ -124,28 +135,23 @@ msgstr "" "colaborar con el proyecto y los escollos que deben evitarse al hacerlo." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:75 +#: documentation/content/en/articles/building-products/_index.adoc:74 #, no-wrap msgid "" "*Caveat Reader.* The author believes that the characteristics of the FreeBSD Project listed in this article were substantially true at the time the article was conceived and written (2005).\n" "However, the reader should keep in mind that the practices and processes used by open-source communities can change over time, and that the information in this article should therefore be taken as indicative rather than normative.\n" msgstr "" -"*Aviso al Lector.* El autor cree que las características del Proyecto " -"FreeBSD enumeradas en este artículo eran sustancialmente verdaderas en el " -"momento en que se concibió y escribió el artículo (2005).\n" -"Sin embargo, el lector debe tener en cuenta que las prácticas y los procesos " -"utilizados por las comunidades de código abierto pueden cambiar con el " -"tiempo y que, por lo tanto, la información de este artículo debe tomarse " -"como indicativa en lugar de normativa.\n" +"*Aviso al Lector.* El autor cree que las características del Proyecto FreeBSD enumeradas en este artículo eran sustancialmente verdaderas en el momento en que se concibió y escribió el artículo (2005).\n" +"Sin embargo, el lector debe tener en cuenta que las prácticas y los procesos utilizados por las comunidades de código abierto pueden cambiar con el tiempo y que, por lo tanto, la información de este artículo debe tomarse como indicativa en lugar de normativa.\n" #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:76 +#: documentation/content/en/articles/building-products/_index.adoc:75 #, no-wrap msgid "Target Audience" msgstr "Público objetivo" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:79 +#: documentation/content/en/articles/building-products/_index.adoc:78 msgid "" "This document would be of interest to the following broad groups of people:" msgstr "" @@ -153,7 +159,7 @@ msgstr "" "personas:" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:81 +#: documentation/content/en/articles/building-products/_index.adoc:80 msgid "" "Decision makers in product companies looking at ways to improve their " "product quality, reduce their time to market and lower engineering costs in " @@ -164,7 +170,7 @@ msgstr "" "comercialización y reducir los costes de ingeniería a largo plazo." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:82 +#: documentation/content/en/articles/building-products/_index.adoc:81 msgid "" "Technology consultants looking for best-practices in leveraging \"open-source" "\"." @@ -173,7 +179,7 @@ msgstr "" "del \"open-source\"." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:83 +#: documentation/content/en/articles/building-products/_index.adoc:82 msgid "" "Industry observers interested in understanding the dynamics of open-source " "projects." @@ -182,7 +188,7 @@ msgstr "" "proyectos de código abierto." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:84 +#: documentation/content/en/articles/building-products/_index.adoc:83 msgid "" "Software developers seeking to use FreeBSD and looking for ways to " "contribute back." @@ -191,18 +197,18 @@ msgstr "" "contribuir." #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:85 +#: documentation/content/en/articles/building-products/_index.adoc:84 #, no-wrap msgid "Article Goals" msgstr "Objetivos del artículo" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:88 +#: documentation/content/en/articles/building-products/_index.adoc:87 msgid "After reading this article you should have:" msgstr "Después de leer este artículo, deberías tener:" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:90 +#: documentation/content/en/articles/building-products/_index.adoc:89 msgid "" "An understanding of the goals of the FreeBSD Project and its organizational " "structure." @@ -211,14 +217,14 @@ msgstr "" "organizativa." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:91 +#: documentation/content/en/articles/building-products/_index.adoc:90 msgid "" "An understanding of its development model and release engineering processes." msgstr "" "Comprensión de su modelo de desarrollo y procesos de ingeniería de versiones." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:92 +#: documentation/content/en/articles/building-products/_index.adoc:91 msgid "" "An understanding of how conventional corporate software development " "processes differ from that used in the FreeBSD project." @@ -227,7 +233,7 @@ msgstr "" "software corporativo difieren de los utilizados en el proyecto FreeBSD." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:93 +#: documentation/content/en/articles/building-products/_index.adoc:92 msgid "" "Awareness of the communication channels used by the project and the level of " "transparency you can expect." @@ -236,7 +242,7 @@ msgstr "" "nivel de transparencia que puede esperar." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:94 +#: documentation/content/en/articles/building-products/_index.adoc:93 msgid "" "Awareness of optimal ways of working with the project-how best to reduce " "engineering costs, improve time to market, manage security vulnerabilities, " @@ -250,18 +256,18 @@ msgstr "" "FreeBSD." #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:95 +#: documentation/content/en/articles/building-products/_index.adoc:94 #, no-wrap msgid "Article Structure" msgstr "Estructura del artículo" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:98 +#: documentation/content/en/articles/building-products/_index.adoc:97 msgid "The rest of the article is structured as follows:" msgstr "El resto del artículo está estructurado de la siguiente manera:" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:100 +#: documentation/content/en/articles/building-products/_index.adoc:99 msgid "" "<> introduces the FreeBSD project, explores its " "organizational structure, key technologies and release engineering processes." @@ -271,7 +277,7 @@ msgstr "" "versiones." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:101 +#: documentation/content/en/articles/building-products/_index.adoc:100 msgid "" "<> describes ways to collaborate with the FreeBSD " "project. It examines common pitfalls encountered by corporates working with " @@ -282,24 +288,24 @@ msgstr "" "trabajando con proyectos basados en voluntariado como FreeBSD." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:102 +#: documentation/content/en/articles/building-products/_index.adoc:101 msgid "<> concludes." msgstr "<> conclusiones." #. type: Title == -#: documentation/content/en/articles/building-products/_index.adoc:104 +#: documentation/content/en/articles/building-products/_index.adoc:103 #, no-wrap msgid "FreeBSD as a set of building blocks" msgstr "FreeBSD como un conjunto de bloques de construcción" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:107 +#: documentation/content/en/articles/building-products/_index.adoc:106 msgid "FreeBSD makes an excellent foundation on which to build products:" msgstr "" "FreeBSD constituye una excelente base sobre la que construir productos:" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:109 +#: documentation/content/en/articles/building-products/_index.adoc:108 msgid "" "FreeBSD source code is distributed under a liberal BSD license facilitating " "its adoption in commercial products <> with minimum hassle." @@ -309,7 +315,7 @@ msgstr "" "molestias." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:110 +#: documentation/content/en/articles/building-products/_index.adoc:109 msgid "" "The FreeBSD project has excellent engineering practices that can be " "leveraged." @@ -318,7 +324,7 @@ msgstr "" "aprovechadas." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:111 +#: documentation/content/en/articles/building-products/_index.adoc:110 msgid "" "The project offers exceptional transparency into its workings, allowing " "organizations using its code to plan effectively for the future." @@ -328,7 +334,7 @@ msgstr "" "eficazmente para el futuro." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:112 +#: documentation/content/en/articles/building-products/_index.adoc:111 msgid "" "The culture of the FreeBSD project, carried over from the Computer Science " "Research Group at The University of California, Berkeley <>, " @@ -341,7 +347,7 @@ msgstr "" "de FreeBSD definen la vanguardia de la técnica." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:115 +#: documentation/content/en/articles/building-products/_index.adoc:114 msgid "" "<> examines the business reasons for using open-source in " "greater detail. For organizations, the benefits of using FreeBSD components " @@ -354,26 +360,26 @@ msgstr "" "al mercado, menores costes de desarrollo y menores riesgos de desarrollo." #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:116 +#: documentation/content/en/articles/building-products/_index.adoc:115 #, no-wrap msgid "Building with FreeBSD" msgstr "Construyendo productos con FreeBSD" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:119 +#: documentation/content/en/articles/building-products/_index.adoc:118 msgid "Here are a few ways organizations have used FreeBSD:" msgstr "" "Estas son algunas de las formas en que las organizaciones han usado FreeBSD:" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:121 +#: documentation/content/en/articles/building-products/_index.adoc:120 msgid "As an upstream source for tested code for libraries and utilities." msgstr "" "Como una fuente de código probado para librerías y empresas de servicios " "públicos." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:123 +#: documentation/content/en/articles/building-products/_index.adoc:122 msgid "" "By being \"downstream\" of the project, organizations leverage the new " "features, bug fixes and testing that the upstream code receives." @@ -383,7 +389,7 @@ msgstr "" "base." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:124 +#: documentation/content/en/articles/building-products/_index.adoc:123 msgid "" "As an embedded OS (for example, for an OEM router and firewall device). In " "this model, organizations use a customized FreeBSD kernel and application " @@ -399,7 +405,7 @@ msgstr "" "de las pruebas que recibe el sistema base." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:126 +#: documentation/content/en/articles/building-products/_index.adoc:125 msgid "" "FreeBSD ships with a self-hosting development environment that allows easy " "creation of such configurations." @@ -408,7 +414,7 @@ msgstr "" "fácilmente estas configuraciones." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:127 +#: documentation/content/en/articles/building-products/_index.adoc:126 msgid "" "As a Unix compatible environment for the management functions of high-end " "storage and networking devices, running on a separate processor \"blade\"." @@ -418,7 +424,7 @@ msgstr "" "procesador independiente \"blade\"." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:131 +#: documentation/content/en/articles/building-products/_index.adoc:130 msgid "" "FreeBSD provides the tools for creating dedicated OS and application program " "images. Its implementation of a BSD unix API is mature and tested. FreeBSD " @@ -432,7 +438,7 @@ msgstr "" "alta." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:132 +#: documentation/content/en/articles/building-products/_index.adoc:131 msgid "" "As a vehicle to get widespread testing and support from a worldwide team of " "developers for non-critical \"intellectual property\"." @@ -441,7 +447,7 @@ msgstr "" "de desarrolladores para \"propiedad intelectual\" no crítica." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:136 +#: documentation/content/en/articles/building-products/_index.adoc:135 msgid "" "In this model, organizations contribute useful infrastructural frameworks to " "the FreeBSD project (for example, see man:netgraph[3]). The widespread " @@ -458,7 +464,7 @@ msgstr "" "la organización que la aportó." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:137 +#: documentation/content/en/articles/building-products/_index.adoc:136 msgid "" "As a development environment supporting cross-development for embedded OSes " "like http://www.rtems.com/[RTEMS] and http://ecos.sourceware.org/[eCOS]." @@ -468,7 +474,7 @@ msgstr "" "sourceware.org/[eCOS]." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:139 +#: documentation/content/en/articles/building-products/_index.adoc:138 msgid "" "There are many full-fledged development environments in the {numports}-" "strong collection of applications ported and packaged with FreeBSD." @@ -477,7 +483,7 @@ msgstr "" "colección de {numports} aplicaciones portadas y empaquetadas con FreeBSD." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:140 +#: documentation/content/en/articles/building-products/_index.adoc:139 msgid "" "As a way to support a Unix-like API in an otherwise proprietary OS, " "increasing its palatability for application developers." @@ -487,7 +493,7 @@ msgstr "" "desarrolladores de aplicaciones." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:144 +#: documentation/content/en/articles/building-products/_index.adoc:143 msgid "" "Here parts of FreeBSD's kernel and application programs are \"ported\" to " "run alongside other tasks in the proprietary OS. The availability of a " @@ -507,13 +513,13 @@ msgstr "" "versiones, los costes de mantenerse actualizado se mantienen bajos." #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:146 +#: documentation/content/en/articles/building-products/_index.adoc:145 #, no-wrap msgid "Technologies" msgstr "Tecnologías" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:150 +#: documentation/content/en/articles/building-products/_index.adoc:149 msgid "" "There are a large number of technologies supported by the FreeBSD project. " "A selection of these are listed below:" @@ -522,16 +528,16 @@ msgstr "" "continuación se enumera una selección de ellos:" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:152 +#: documentation/content/en/articles/building-products/_index.adoc:151 msgid "" "A complete system that can cross-host itself for link:https://www.FreeBSD." "org/platforms/[many architectures:]" msgstr "" -"Un sistema completo que puede auto alojarse de forma cruzada en " -"link:https://www.FreeBSD.org/platforms/[muchas arquitecturas:]" +"Un sistema completo que puede auto alojarse de forma cruzada en link:https://" +"www.FreeBSD.org/platforms/[muchas arquitecturas:]" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:153 +#: documentation/content/en/articles/building-products/_index.adoc:152 msgid "" "A modular symmetric multiprocessing capable kernel, with loadable kernel " "modules and a flexible and easy to use configuration system." @@ -541,7 +547,7 @@ msgstr "" "usar." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:154 +#: documentation/content/en/articles/building-products/_index.adoc:153 msgid "" "Support for emulation of Linux(TM) and SVR4 binaries at near machine speeds. " "Support for binary Windows(TM) (NDIS) network drivers." @@ -551,7 +557,7 @@ msgstr "" "de Winwos(TM)." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:155 +#: documentation/content/en/articles/building-products/_index.adoc:154 msgid "" "Libraries for many programming tasks: archivers, FTP and HTTP support, " "thread support, in addition to a full POSIX(TM) like programming environment." @@ -561,7 +567,7 @@ msgstr "" "POSIX(TM)." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:156 +#: documentation/content/en/articles/building-products/_index.adoc:155 msgid "" "Security features: Mandatory Access Control (man:mac[9]), jails (man:" "jail[2]), ACLs, and in-kernel cryptographic device support." @@ -571,7 +577,7 @@ msgstr "" "núcleo." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:157 +#: documentation/content/en/articles/building-products/_index.adoc:156 msgid "" "Networking features: firewall-ing, QoS management, high-performance TCP/IP " "networking with support for many extensions." @@ -581,7 +587,7 @@ msgstr "" "extensiones." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:159 +#: documentation/content/en/articles/building-products/_index.adoc:158 msgid "" "FreeBSD's in-kernel Netgraph (man:netgraph[4]) framework allows kernel " "networking modules to be connected together in flexible ways." @@ -591,7 +597,7 @@ msgstr "" "flexibles." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:160 +#: documentation/content/en/articles/building-products/_index.adoc:159 msgid "" "Support for storage technologies: Fibre Channel, SCSI, software and hardware " "RAID, ATA and SATA." @@ -600,7 +606,7 @@ msgstr "" "software y hardware, ATA y SATA." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:162 +#: documentation/content/en/articles/building-products/_index.adoc:161 msgid "" "FreeBSD supports a number of filesystems, and its native UFS2 filesystem " "supports soft updates, snapshots and very large filesystem sizes (16TB per " @@ -611,7 +617,7 @@ msgstr "" "ficheros muy grandes (16TB por sistema de ficheros) <>." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:164 +#: documentation/content/en/articles/building-products/_index.adoc:163 msgid "" "FreeBSD's in-kernel GEOM (man:geom[4]) framework allows kernel storage " "modules to be composed in flexible ways." @@ -620,7 +626,7 @@ msgstr "" "módulos de almacenamiento del kernel configurarse de formas flexibles." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:165 +#: documentation/content/en/articles/building-products/_index.adoc:164 msgid "" "Over {numports} ported applications, both commercial and open-source, " "managed via the FreeBSD ports collection." @@ -629,18 +635,18 @@ msgstr "" "gestionadas mediante la colección de ports de FreeBSD." #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:166 +#: documentation/content/en/articles/building-products/_index.adoc:165 #, no-wrap msgid "Organizational Structure" msgstr "Estructura de la organización" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:169 +#: documentation/content/en/articles/building-products/_index.adoc:168 msgid "FreeBSD's organizational structure is non-hierarchical." msgstr "La estructura organizativa de FreeBSD no es jerárquica." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:171 +#: documentation/content/en/articles/building-products/_index.adoc:170 msgid "" "There are essentially two kinds of contributors to FreeBSD, general users of " "FreeBSD, and developers with write access (known as _committers_ in the " @@ -651,7 +657,7 @@ msgstr "" "código fuente (conocidos como _committers_ en la jerga)." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:175 +#: documentation/content/en/articles/building-products/_index.adoc:174 msgid "" "There are many thousands of contributors in the first group; the vast " "majority of contributions to FreeBSD come from individuals in this group. " @@ -669,19 +675,19 @@ msgstr "" "aprender lo que hay que hacer." #. type: Block title -#: documentation/content/en/articles/building-products/_index.adoc:176 +#: documentation/content/en/articles/building-products/_index.adoc:175 #, no-wrap msgid "FreeBSD Organization" msgstr "Organización de FreeBSD" #. type: Target for macro image -#: documentation/content/en/articles/building-products/_index.adoc:177 +#: documentation/content/en/articles/building-products/_index.adoc:176 #, no-wrap msgid "freebsd-organization.png" msgstr "freebsd-organization.png" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:180 +#: documentation/content/en/articles/building-products/_index.adoc:179 msgid "" "Conflict resolution is performed by a nine member \"Core Team\" that is " "elected from the group of committers." @@ -690,31 +696,32 @@ msgstr "" "miembros que es escogido entre el grupo de committers." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:184 +#: documentation/content/en/articles/building-products/_index.adoc:183 msgid "" "FreeBSD does not have \"corporate\" committers. Individual committers are " "required to take responsibility for the changes they introduce to the code. " -"The link:{committers-guide}[FreeBSD Committer's guide] <> " +"The extref:{committers-guide}[FreeBSD Committer's guide] <> " "documents the rules and responsibilities for committers." msgstr "" "FreeBSD no tiene committers \"corporativos\". A los committers individuales " "se les requiere que asuman la responsabilidad de los cambios que introducen " -"en el código. La link:{committers-guide}[FreeBSD Committer's guide] " +"en el código. La extref:{committers-guide}[FreeBSD Committer's guide] " "<> documenta las reglas y responsabilidades de los committers." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:186 +#: documentation/content/en/articles/building-products/_index.adoc:185 msgid "FreeBSD's project model is examined in detail in <>." -msgstr "El modelo de proyecto de FreeBSD se examina con detalle en <>." +msgstr "" +"El modelo de proyecto de FreeBSD se examina con detalle en <>." #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:187 +#: documentation/content/en/articles/building-products/_index.adoc:186 #, no-wrap msgid "FreeBSD Release Engineering Processes" msgstr "Procesos de ingeniería de lanzamiento de versiones de FreeBSD" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:191 +#: documentation/content/en/articles/building-products/_index.adoc:190 msgid "" "FreeBSD's release engineering processes play a major role in ensuring that " "its released versions are of a high quality. At any point of time, " @@ -727,7 +734,7 @@ msgstr "" "freebsd-branches, FreeBSD Release Branches>>):" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:193 +#: documentation/content/en/articles/building-products/_index.adoc:192 msgid "" "New features and disruptive code enters on the development branch, also " "known as the _-CURRENT_ branch." @@ -736,7 +743,7 @@ msgstr "" "también conocida como la rama _-CURRENT_." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:194 +#: documentation/content/en/articles/building-products/_index.adoc:193 msgid "" "_-STABLE_ branches are code lines that are branched from HEAD at regular " "intervals. Only tested code is allowed onto a -STABLE branch. New features " @@ -748,7 +755,7 @@ msgstr "" "estabilizadas en la rama -CURRENT." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:195 +#: documentation/content/en/articles/building-products/_index.adoc:194 msgid "" "_-RELEASE_ branches are maintained by the FreeBSD security team. Only bug " "fixes for critical issues are permitted onto -RELEASE branches." @@ -757,19 +764,19 @@ msgstr "" "Sólo se permiten arreglos críticos en las ramas -RELEASE." #. type: Block title -#: documentation/content/en/articles/building-products/_index.adoc:197 +#: documentation/content/en/articles/building-products/_index.adoc:196 #, no-wrap msgid "FreeBSD Release Branches" msgstr "Ramas RELEASE de FreeBSD" #. type: Target for macro image -#: documentation/content/en/articles/building-products/_index.adoc:198 +#: documentation/content/en/articles/building-products/_index.adoc:197 #, no-wrap msgid "freebsd-branches.png" msgstr "freebsd-branches.png" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:201 +#: documentation/content/en/articles/building-products/_index.adoc:200 msgid "" "Code lines are kept alive for as long as there is user and developer " "interest in them." @@ -778,24 +785,24 @@ msgstr "" "parte del usuario y del desarrollador." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:204 +#: documentation/content/en/articles/building-products/_index.adoc:203 msgid "" "Machine architectures are grouped into \"tiers\"; _Tier 1_ architectures are " "fully supported by the project's release engineering and security teams, " "_Tier 2_ architectures are supported on a best effort basis, and " -"experimental architectures comprise _Tier 3_. The list of link:{committers-" -"guide}#archs[supported architectures] is part of the FreeBSD documentation " -"collection." +"experimental architectures comprise _Tier 3_. The list of extref:" +"{committers-guide}[supported architectures, archs] is part of the FreeBSD " +"documentation collection." msgstr "" "Las arquitecturas se agrupan en \"tiers\"; Las arquitecturas _Tier 1_ están " "soportadas por completo por los equipos de seguridad y de ingeniería de " "versiones del proyecto, las arquitecturas _Tier 2_ están soportadas lo mejor " "posible y _Tier 3_ está compuesto de arquitecturas experimentales. La lista " -"de link:{committers-guide}#archs[arquitecturas soportadas] es parte de la " +"de extref:{committers-guide}[arquitecturas soportadas,archs] es parte de la " "colección de documentación de FreeBSD." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:207 +#: documentation/content/en/articles/building-products/_index.adoc:206 msgid "" "The release engineering team publishes a link:https://www.FreeBSD.org/releng/" "[road map] for future releases of FreeBSD on the project's web site. The " @@ -808,20 +815,20 @@ msgstr "" "FreeBSD se libera cuando el código y la documentación están listos." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:209 +#: documentation/content/en/articles/building-products/_index.adoc:208 msgid "FreeBSD's release engineering processes are described in <>." msgstr "" "Los procesos de ingeniería de versiones de FreeBSD se describen en " "<>." #. type: Title == -#: documentation/content/en/articles/building-products/_index.adoc:211 +#: documentation/content/en/articles/building-products/_index.adoc:210 #, no-wrap msgid "Collaborating with FreeBSD" msgstr "Colaborando con FreeBSD" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:214 +#: documentation/content/en/articles/building-products/_index.adoc:213 msgid "" "Open-source projects like FreeBSD offer finished code of a very high quality." msgstr "" @@ -829,7 +836,7 @@ msgstr "" "alta calidad." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:219 +#: documentation/content/en/articles/building-products/_index.adoc:218 msgid "" "While access to quality source code can reduce the cost of initial " "development, in the long-term the costs of managing change begin to " @@ -851,7 +858,7 @@ msgstr "" "transparente." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:221 +#: documentation/content/en/articles/building-products/_index.adoc:220 msgid "" "FreeBSD has an active developer community around it. At the time of writing " "there are many thousands of contributors from every populated continent in " @@ -864,12 +871,12 @@ msgstr "" "escritura a los repositorios de fuentes del proyecto." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:222 +#: documentation/content/en/articles/building-products/_index.adoc:221 msgid "The goals of the FreeBSD project are <>:" msgstr "Los objetivos del proyecto FreeBSD son <>:" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:224 +#: documentation/content/en/articles/building-products/_index.adoc:223 msgid "" "To develop a high-quality operating system for popular computer hardware, " "and," @@ -878,37 +885,36 @@ msgstr "" "informáticos más utilizados, y," #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:225 +#: documentation/content/en/articles/building-products/_index.adoc:224 msgid "To make our work available to all under a liberal license." msgstr "" "Poner nuestro trabajo a disposición de todos bajo una licencia liberal." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:227 +#: documentation/content/en/articles/building-products/_index.adoc:226 msgid "" "FreeBSD enjoys an open and transparent working culture. Nearly all " -"discussion in the project happens by email, on https://lists.freebsd.org/" -"mailman/listinfo[public mailing lists] that are also archived for posterity. " -"The project's policies are link:https://www.FreeBSD.org/internal/policies/" +"discussion in the project happens by email, on link:https://lists.freebsd." +"org/[public mailing lists] that are also archived for posterity. The " +"project's policies are link:https://www.FreeBSD.org/internal/policies/" "[documented] and maintained under revision control. Participation in the " "project is open to all." msgstr "" "FreeBSD disfruta de una cultura de trabajo abierta y transparente. " -"Prácticamente toda la discusión en el proyecto se produce por email, en " -"https://lists.freebsd.org/mailman/listinfo[listas públicas de correo] que " -"son archivadas para la posteridad. Las políticas del proyecto están " -"link:https://www.FreeBSD.org/internal/policies/[documentadas] y mantenidas " -"bajo control de versiones. La participación en el proyecto está abierta a " -"cualquiera." +"Prácticamente toda la discusión en el proyecto se produce por email, en link:" +"https://lists.freebsd.org/[listas públicas de correo] que son archivadas " +"para la posteridad. Las políticas del proyecto están link:https://www." +"FreeBSD.org/internal/policies/[documentadas] y mantenidas bajo control de " +"versiones. La participación en el proyecto está abierta a cualquiera." #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:229 +#: documentation/content/en/articles/building-products/_index.adoc:228 #, no-wrap msgid "Understanding FreeBSD culture" msgstr "Comprendiendo la cultura de FreeBSD" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:232 +#: documentation/content/en/articles/building-products/_index.adoc:231 msgid "" "To be able to work effectively with the FreeBSD project, you need to " "understand the project's culture." @@ -917,7 +923,7 @@ msgstr "" "cultura del proyecto." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:235 +#: documentation/content/en/articles/building-products/_index.adoc:234 msgid "" "Volunteer driven projects operate under different rules than for-profit " "corporates. A common mistake that companies make when venturing into the " @@ -929,55 +935,39 @@ msgstr "" "diferencias." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:237 +#: documentation/content/en/articles/building-products/_index.adoc:236 #, no-wrap msgid "*Motivation.* Most contributions to FreeBSD are done voluntarily without monetary rewards entering the picture. The factors that motivate individuals are complex, ranging from altruism, to an interest in solving the kinds of problems that FreeBSD attempts to solve. In this environment, \"elegance is never optional\"<>.\n" -msgstr "" -"La mayoría de las contribuciones a FreeBSD se hacen voluntariamente sin que " -"las recompensas económicas entren en escena. Los factores que motivan a los " -"individuos son complejos, desde el altruismo hasta el interés por resolver " -"los tipos de problemas que FreeBSD intenta resolver. En este entorno, la " -"\"elegancia nunca es opcional\" <>.\n" +msgstr "La mayoría de las contribuciones a FreeBSD se hacen voluntariamente sin que las recompensas económicas entren en escena. Los factores que motivan a los individuos son complejos, desde el altruismo hasta el interés por resolver los tipos de problemas que FreeBSD intenta resolver. En este entorno, la \"elegancia nunca es opcional\" <>.\n" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:239 +#: documentation/content/en/articles/building-products/_index.adoc:238 #, no-wrap msgid "*The Long Term View.* FreeBSD traces its roots back nearly twenty years to the work of the Computer Science Research Group at the University of California Berkeley.footnote:[FreeBSD's source repository contains a history of the project since its inception, and there are CDROMs available that contain earlier code from the CSRG.] A number of the original CSRG developers remain associated with the project.\n" -msgstr "" -"*La Visión a Largo Plazo.* FreeBSD tiene sus raíces hace casi veinte años en " -"el trabajo del Grupo de Investigación de Ciencias de la Computación de la " -"Universidad de California en Berkeley.footnote:[El repositorio de código " -"fuente de FreeBSD contiene la historia del proyecto desde sus comienzos y " -"hay CDROMs disponibles que contienen código anterior del CSRG]. Cierto " -"número de los desarrolladores originales del CSRG siguen asociados al " -"proyecto.\n" +msgstr "*La Visión a Largo Plazo.* FreeBSD tiene sus raíces hace casi veinte años en el trabajo del Grupo de Investigación de Ciencias de la Computación de la Universidad de California en Berkeley.footnote:[El repositorio de código fuente de FreeBSD contiene la historia del proyecto desde sus comienzos y hay CDROMs disponibles que contienen código anterior del CSRG]. Cierto número de los desarrolladores originales del CSRG siguen asociados al proyecto.\n" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:241 +#: documentation/content/en/articles/building-products/_index.adoc:240 msgid "" "The project values long-term perspectives <>. A frequent acronym " "encountered in the project is DTRT, which stands for \"Do The Right Thing\"." msgstr "" "Las perspectivas a largo plazo de los valores del proyecto <>. Un " -"acrónimo encontrado frecuentemente en el proyecto es DTRT, que significa \"Do" -" The Right Thing\" (\"haz lo correcto\")." +"acrónimo encontrado frecuentemente en el proyecto es DTRT, que significa " +"\"Do The Right Thing\" (\"haz lo correcto\")." #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:244 +#: documentation/content/en/articles/building-products/_index.adoc:243 #, no-wrap msgid "" "*Development Processes.* Computer programs are tools for communication: at one level programmers communicate their intentions using a precise notation to a tool (a compiler) that translates their instructions to executable code.\n" "At another level, the same notation is used for communication of intent between two programmers.\n" msgstr "" -"*Procesos de Desarrollo.* Los programas de ordenador son herramientas para " -"la comunicación: a un nivel los programadores comunican sus intenciones " -"utilizando una notación precisa a una herramienta (un compilador) que " -"traduce sus instrucciones a código ejecutable.\n" -"A otro nivel, la misma notación es utilizada para la comunicación de " -"intenciones entre dos programadores.\n" +"*Procesos de Desarrollo.* Los programas de ordenador son herramientas para la comunicación: a un nivel los programadores comunican sus intenciones utilizando una notación precisa a una herramienta (un compilador) que traduce sus instrucciones a código ejecutable.\n" +"A otro nivel, la misma notación es utilizada para la comunicación de intenciones entre dos programadores.\n" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:248 +#: documentation/content/en/articles/building-products/_index.adoc:247 msgid "" "Formal specifications and design documents are seldom used in the project. " "Clear and well-written code and well-written change logs (<>." #. type: delimited block . 4 -#: documentation/content/en/articles/building-products/_index.adoc:254 +#: documentation/content/en/articles/building-products/_index.adoc:253 #, no-wrap msgid "" "r151864 | bde | 2005-10-29 09:34:50 -0700 (Sat, 29 Oct 2005) | 13 lines\n" @@ -1003,7 +993,7 @@ msgstr "" " M /head/lib/msun/src/e_rem_pio2f.c\n" *** 476 LINES SKIPPED *** From nobody Wed Nov 24 17:46:33 2021 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 06CAE189E496 for ; Wed, 24 Nov 2021 17:46:34 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HzpN95CbQz3D77; Wed, 24 Nov 2021 17:46:33 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 8EAA86555; Wed, 24 Nov 2021 17:46:33 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AOHkXbb027058; Wed, 24 Nov 2021 17:46:33 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AOHkXkq027057; Wed, 24 Nov 2021 17:46:33 GMT (envelope-from git) Date: Wed, 24 Nov 2021 17:46:33 GMT Message-Id: <202111241746.1AOHkXkq027057@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: b10e505894 - main - 12.3 schedule: remove RC3 as it is not needed 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gjb X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: b10e50589425bc92e2eb772eb68ea4c1f4728e11 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1637775993; 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; bh=pgt1UsOn7KkiDF8nKngPegdnAMGdqx2JsE1EB0cHJ88=; b=UR/bLCLK3MMUnuq0wOKROmaCqVDfVOxEYximMb/MdiQhZ4xo08Wmgj7EsQxVzeHbu7Qfzm VYvlupm88/SVD5lCu/zLz0DNvHM5IZhzgXLe7dxM1VavtXTDI+qSNk3fRaJbibB5G01EhM mDxg5ZTGttCS+x9bK72SiTx/fdyEdcAqvbmg9ySMlaWNzkVu0kSaTXD/+b7y/1Vc7j9kLp Yw7lmfb6mt4qGgnzaQ6vEWzNLQayehvBwvLtK7CsZi6/GnmPuqVabgZOYPUlg4X052CWbw OwjJj1e+Pc7Cq4ohPcww5mZc1J81shLA+Vy09pZ6WMPdY+qUEU/mhiGcyANg3Q== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1637775993; a=rsa-sha256; cv=none; b=S8v0TlEhuyRMDy0WPGy4NLfKZReLwKT8WAhygQqFiu1FXSSnTvaNV6VKxQyi03X9M+mgUF vtSYOoVpBel5/gr7CM7IDtPIGsGMocaO0JeieyaxITYQugCcunGzt5VP4QlxPRGp5CVmai 6gA8ohECogHjG8Qufbx0EjRNt/sAMJxhWvyHV4MUOum+L1QWOCjDs88jbnnDEHYrDxF0KV 1gai2AFONejufvPxoW539/flmnoBXI3rzBSctUKckSgfexGtwysZWDrqhgxlSSrjLaf41l BKTK0rq7kqxMn74fCmYOa25ko+DsabnUq1cSByTDVRE79WjGf9S1RdXkycfj4A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=b10e50589425bc92e2eb772eb68ea4c1f4728e11 commit b10e50589425bc92e2eb772eb68ea4c1f4728e11 Author: Glen Barber AuthorDate: 2021-11-24 17:45:15 +0000 Commit: Glen Barber CommitDate: 2021-11-24 17:45:15 +0000 12.3 schedule: remove RC3 as it is not needed Sponsored by: Rubicon Communications, LLC ("Netgate") --- website/content/en/releases/12.3R/schedule.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/releases/12.3R/schedule.adoc b/website/content/en/releases/12.3R/schedule.adoc index 6dc72904f5..95ecea28e2 100644 --- a/website/content/en/releases/12.3R/schedule.adoc +++ b/website/content/en/releases/12.3R/schedule.adoc @@ -35,7 +35,7 @@ link:{handbook}#mfc-glossary[MFC] requests are no longer being accepted. |BETA3 builds begin |4 November 2021 |4 November 2021 |Third beta test snapshot. |RC1 builds begin |11 November 2021 |11 November 2021 |First release candidate. |RC2 builds begin |18 November 2021 |18 November 2021 |Second release candidate. -|RC3 builds begin* |25 November 2021 |- |Third release candidate. +|RC3 builds begin |25 November 2021 |(not needed) |Third release candidate. |RELEASE builds begin |2 December 2021 |- |{localRel}-RELEASE builds begin. |RELEASE announcement |6 December 2021 |- |{localRel}-RELEASE press release. |Turn over to the secteam |- |- |{localBranchReleng} branch is handed over to the FreeBSD Security Officer Team in one or two weeks after the announcement. From nobody Wed Nov 24 17:46:34 2021 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 1D757189E49B for ; Wed, 24 Nov 2021 17:46:35 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HzpNB5n4Fz3DDQ; Wed, 24 Nov 2021 17:46:34 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id A838E614C; Wed, 24 Nov 2021 17:46:34 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AOHkYkC027082; Wed, 24 Nov 2021 17:46:34 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AOHkYtU027081; Wed, 24 Nov 2021 17:46:34 GMT (envelope-from git) Date: Wed, 24 Nov 2021 17:46:34 GMT Message-Id: <202111241746.1AOHkYtU027081@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: e2b64552da - main - releng: belatedly add releng/12.3 to the branch list 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gjb X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e2b64552da47ff86a4a942034021b0b0e11c9deb Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1637775994; 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; bh=kcKPm26Pgu0YjV5SSotzWkLOwRUMDagtiBT/tD+QuJo=; b=HujdW12Oph4mxl5ZIpFDP7Ac+3+dI2c9yMlkqLqeOGabmBOvcuJ4lmdcjSLtJpKQFcZbp0 DzMFFlIhvf7PPcyPJhmhuhhDZbB42DiQG9M8GcADvU81GQHdgmLV/6ZNaDyOnvOS3rIrT4 vtmST6/Yz/ykuXISRL4WeHWaSYYUFH+9v9TmWfwQbX50VVN4Td/bP1RFv168PoHWa0FLA9 24L9Ehz9BuFCOfdcNTfrfN2oLWPY6T0Z3C16WplMhFdDou7U13OIngNPXeaO+BbwJYLrR/ Z/qiYcCSTdsJfNrHE0gJJ10xs4hUSSHXJwUj1bbIxcD5dnv/ITBfdvZ0FlntSg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1637775994; a=rsa-sha256; cv=none; b=GEvxMPcPPDq3ahamd7suzGLfpOO+B4T4LJDjF/iMqovwStz/NtZ/xBJup9mJgnqNIsDrUj V+IFqb8s1lNYsUVgXh2z0FuruXPdLcItZSR2YsXWZt6Xn/E201yNufRCIHtbg3u515U1YL BKavaB0ty26fIrUQX3+ZIBodxPLgbsbyJV0BePhu4TWdabstxtCZ4+N0KGNlPbrPA6Ky3a vSzFK2lH3YnbiVHj3bnIa9AIwJ9l0LvuM1cQdvV+6m+/ImHawCf24nJBvbxvTJlzAzoUsR 2vybOcXOG2NDrKsp1bHCc2Vien8sxNWk5+qlAKcvegJOvUolLEQS12vbVNryrg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=e2b64552da47ff86a4a942034021b0b0e11c9deb commit e2b64552da47ff86a4a942034021b0b0e11c9deb Author: Glen Barber AuthorDate: 2021-11-24 17:46:10 +0000 Commit: Glen Barber CommitDate: 2021-11-24 17:46:10 +0000 releng: belatedly add releng/12.3 to the branch list Sponsored by: Rubicon Communications, LLC ("Netgate") --- website/content/en/releng/_index.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/website/content/en/releng/_index.adoc b/website/content/en/releng/_index.adoc index 84b4cd5eb9..6d807cd72a 100644 --- a/website/content/en/releng/_index.adoc +++ b/website/content/en/releng/_index.adoc @@ -48,6 +48,7 @@ This table lists the code freeze status for major branches of the `src/` reposit |`stable/13` |Open |committers |Development branch for FreeBSD 13-STABLE. |`releng/13.0` |Frozen |so@FreeBSD.org |FreeBSD 13.0 supported errata fix branch. |`stable/12` |Open |committers |Development branch for FreeBSD 12-STABLE. +|`releng/12.3`|Frozen|re@FreeBSD.org|FreeBSD 12.3 supported errata fix branch. |`releng/12.2`|Frozen|security-officer@FreeBSD.org|FreeBSD 12.2 supported errata fix branch. |`releng/12.1` |Frozen |security-officer@FreeBSD.org |FreeBSD 12.1 errata fix branch (not officially supported). |`releng/12.0` |Frozen |security-officer@FreeBSD.org |FreeBSD 12.0 errata fix branch (not officially supported). From nobody Wed Nov 24 18:12:18 2021 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 185FD18AC940 for ; Wed, 24 Nov 2021 18:12:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Hzpxt5jvgz3NQr; Wed, 24 Nov 2021 18:12:18 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id A5D7F6A52; Wed, 24 Nov 2021 18:12:18 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AOICI9u067640; Wed, 24 Nov 2021 18:12:18 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AOICIrt067639; Wed, 24 Nov 2021 18:12:18 GMT (envelope-from git) Date: Wed, 24 Nov 2021 18:12:18 GMT Message-Id: <202111241812.1AOICIrt067639@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: 7d5e61ec30 - main - pgpkeys: update key for dhw 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gjb X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 7d5e61ec30e6aaa99b0ab88a9c921d778dba3101 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1637777538; 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; bh=xu2lc04qPEgQ2+ZlQl7+dlJyTcCdxmiLqERaxfW4aes=; b=bqXQTZKkLqq4XCPGoUmxw9dQTW46E/paUtTamo+8FfsR/ZXzT2h7wZR748GQhOQCqxbiMk cb1Iy2jn97TQCH0me21lghv9opU60+scmxeRo5/AzfaMi8hzFp9GLs9KYlsx6AOUJaRvw5 jaXtnX/r0ejL9n2SQkDtIHrSsCHqFxwjmbx0PF0OT9UmqSez/KyzGuDOe1MDPGS26v9tmN fkzPJa98hch4Nbf9owfg8CUWwnrhF2R/H4RMaRJ7QwUcO598qShF7QYCNAvkZ2AHN4qTNK WZuuIG6sJ/oeFcqhvfUiPHJQcdfIPY5NeNEhNSn3NRNMmLcHTGvY/jDmqr/t9w== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1637777538; a=rsa-sha256; cv=none; b=LBfXZUXDSrP2bYo2RZCq8aqlWE4F9MndGOVPthjZGuVgaCAKoaFcwdrtnVUEXRhNempgvF pn9Dty2jOg+pcqhiO2K7Ftk390mJXUOvaOEiiPOvF6LuzykGB9EXHftRltRBNyfDIMPuir WA7MpZZ0tQkxY/LKVy0PuvYoTAjRtLyp5JziYZmS2+OLQHu/zcD7D7GL2+LC5yKdXc4dvL NdI1annHb+CPpUBGVCoNc4Kl+mN2GutWceELqxT9M52QQBXIi+U7FG0BLtJLuEnil6AWEL YKag3+bKVO4ak8jv6Ef2KQJmdySDqOvCNkZ3P7S4nd/BMZasWIZPWdbBkEfA7A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=7d5e61ec30e6aaa99b0ab88a9c921d778dba3101 commit 7d5e61ec30e6aaa99b0ab88a9c921d778dba3101 Author: Glen Barber AuthorDate: 2021-11-24 18:12:00 +0000 Commit: Glen Barber CommitDate: 2021-11-24 18:12:00 +0000 pgpkeys: update key for dhw Sponsored by: Rubicon Communications, LLC ("Netgate") --- documentation/static/pgpkeys/dhw.key | 54 ++++++++++-------------------------- 1 file changed, 15 insertions(+), 39 deletions(-) diff --git a/documentation/static/pgpkeys/dhw.key b/documentation/static/pgpkeys/dhw.key index a5492f2c22..335b72cb7e 100644 --- a/documentation/static/pgpkeys/dhw.key +++ b/documentation/static/pgpkeys/dhw.key @@ -1,11 +1,11 @@ -// sh addkey.sh dhw 40B260F9B6363DC9 ; +// sh addkey.sh dhw B4FBA3DF578231D4 ; [.literal-block-margin] .... -pub rsa2048/40B260F9B6363DC9 2018-11-25 [SC] [expires: 2021-11-24] - Key fingerprint = E28C 33D9 0C4C 2726 B101 E7F2 40B2 60F9 B636 3DC9 +pub ed25519/B4FBA3DF578231D4 2021-11-24 [SC] [expires: 2023-11-24] + Key fingerprint = ABD0 ACEF F942 5163 7C1F 3A28 B4FB A3DF 5782 31D4 uid David H. Wolfskill -sub rsa2048/25F35285016249E6 2018-11-25 [E] [expires: 2021-11-24] +sub cv25519/A06D4B9DA5B47D0F 2021-11-24 [E] [expires: 2023-11-24] .... @@ -13,40 +13,16 @@ sub rsa2048/25F35285016249E6 2018-11-25 [E] [expires: 2021-11-24] .... -----BEGIN PGP PUBLIC KEY BLOCK----- -mQENBFv6tagBCADaJKP8krQnjQtQMIiIKt2EpRSPQLBY4Wy1xuq+RDioh3EymMPw -JTLyGL/n5mY45i5CQKcFJrJo04N+tH9jML19eT2D+h/vzbHknQbCvKJzlUACtFGT -6rT0gWU08jSW6h9h2WdqZ1EKT+hKCPWyE2IDXfZKmduIkAj9OvlqCVEpxdBaoEkM -53WqyVv15uYYoPG7z3ekV46qaA5nI6rh7G1tfjnB4AGXKISRvIT1yTDeelyo+rJO -/6trhT+/ObleCUJflx4rIw0xu2p5TH3xZNwsXJR43frMfVzFHDQLqErgKyXlmtQN -f0HHZ4OiqitUxE4NYDQcHiTjaKaPC0j2JEJhABEBAAG0KURhdmlkIEguIFdvbGZz -a2lsbCA8ZGF2aWRAY2F0d2hpc2tlci5vcmc+iQFUBBMBCgA+FiEE4owz2QxMJyax -AefyQLJg+bY2PckFAlv6tagCGwMFCQWjmoAFCwkIBwMFFQoJCAsFFgMCAQACHgEC -F4AACgkQQLJg+bY2PcnL2Qf/fji42J64GnM8O/6b63rAOMaDePfcbGxltnA1la+e -nhFnmXV1cLEZUUjVwm/GQRGAzFwjmEWIYDzUsHi9yTfF/IoB5OTxdc2YnvcTsg6n -yD22YoF4mZ+LQ/wxZv86RW404AC3+uRHN83dn+mcwSj6TCiAnV5PPgz+C+07vrWy -lC/qq2e1oVyFCUh3AuEle25vvKPKiOEaaqPhQpyeG8iDDz/CY4noLvUhkRwEZ2oe -u0gqKD64hx3EjeDwPBi+HJ0LFJeN9HF1gO11DYAyADwORwJHiHZA3mM3pkNcqVaV -KL0z148RNax1VglpX2WslQLkterMBPtX68JtlPa8GyUAA4kBMwQQAQoAHRYhBMy3 -zvkXqAH0MGTXexU5zECgSe4XBQJb+rZ2AAoJEBU5zECgSe4X4JQIAJAYmM+EdssS -l5JGGAbjt5rVWHSnYSkP6o4w93DXne5q/ZA0GnQEn4sylLBK8+lgCMTL6jiOMaS/ -bu3q7E4MrX0UWOxUpYGm5RxpgS5qnCMz+iRypzpqYy8k7IwMiigd9aWLRxUTpmUz -Cwz7wkTOZThSnCkxYe1KEYyr9QmV9/add0jAqKcT+T75SEP6t6dpFgjB+nAVKdsh -JlWPjR3AK7ap98929Dpk8NkumxZ4+voEv4tPBrvDPqRxcZtg53ZUMC6+Wyqegb72 -D9FdEPaElNlKp1E09+tXrLNzMhzhM9Ck9V4Y+uPH5DS/gmuibJrFkHBB74J9pVRl -NoYFN8tnNpm5AQ0EW/q1qAEIAMDsu2S4FVjT25TsGqnbCr9zJBH0ba0WEo0qpyl1 -j8oSKpehvjuoPcGxbWSm+uXC1tP5sd2MHU3GY79hWCxZssPI2OnquQ8ZsAHnCUlt -8WvgD/PQvXtmZLrcjKymd1xjNZNXNRvKJCCciTcmm/gcg24OYribeLYxy12cb0RF -2zEuyDguO3J5nh79rcv26HeCTFw/+0WFROyjGa7CWxUrnVx167AI4/rpAaCbc8Bu -qd2nzVpKpFai4oPtwjg+0pgIRiInGppqqKJItYLsWxPrPopku0ej8s6j8Chv1Mqp -inos6Bc3eK5WiHWfzXpfukczBkXRFvTuoNvTcFOJpKff2rUAEQEAAYkBPAQYAQoA -JhYhBOKMM9kMTCcmsQHn8kCyYPm2Nj3JBQJb+rWoAhsMBQkFo5qAAAoJEECyYPm2 -Nj3Jq5EIAIs7Zum4O0VZbmKYE/I32+qw4K1LlFVl/ldXE+gFotW7CGFMFAdjLjJm -juV/qemd0iQDmcThIB/NyIVEvCojxHBQjMeeU6Y9F+x4tv6Xk8oMECxsNaRirIsA -O0NpEOCggY89ZvK98nY4pGOK5SZ7S9vQvW35SrbIS9Dhlo8t2+HFlnPwfq7FT2sE -ju4qHsR0BPvDU7ikr0bA4U24rz9eXf1pVZssXzn4WAnPS0dS81I847LevgglBRqz -o5c37SulRQXhYmQAp03T7mNt1j8JLW05ezeT9efiIxyFEhqSL2HqQbMlufsJ9crB -gkdxJAbPg5r0xPdnPKK7GFrcKi+dyUg= -=pEyD +mDMEYZ5ZqhYJKwYBBAHaRw8BAQdAWc7ZDXt4gQY3A+ShR6z7OeicdENJ8aKV6oMx +yMBPtKG0KURhdmlkIEguIFdvbGZza2lsbCA8ZGF2aWRAY2F0d2hpc2tlci5vcmc+ +iJYEExYKAD4WIQSr0Kzv+UJRY3wfOii0+6PfV4Ix1AUCYZ5ZqgIbAwUJA8JnAAUL +CQgHAwUVCgkICwUWAwIBAAIeBQIXgAAKCRC0+6PfV4Ix1JDKAP92sEJPaZzSavk+ +4a7vaznZ5r+XI5ngD/PMkIYL/1qBCgEAtiXf1DHgcvWHDVzxotYvMm8M92bKZDAi ++gV+nQiDbAm4OARhnlmqEgorBgEEAZdVAQUBAQdAa77j+eENx2NpN+tNiZ5VCeMx +FSjLum48swyU5d0slCgDAQgHiH4EGBYKACYWIQSr0Kzv+UJRY3wfOii0+6PfV4Ix +1AUCYZ5ZqgIbDAUJA8JnAAAKCRC0+6PfV4Ix1J1hAQDSPAmWtTI95PqKhL+BgGJH +cUmwULElrvS/h4Byp2z4cwEA+twRLf40wllYI3lMsDsbdSyuJdNfb5aSbUD+aDwj +SgY= +=nw9O -----END PGP PUBLIC KEY BLOCK----- .... - From nobody Thu Nov 25 22:13:48 2021 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 4966B18ACE08 for ; Thu, 25 Nov 2021 22:13:49 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4J0XG471nsz4tlH; Thu, 25 Nov 2021 22:13:48 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id D1B3B254C0; Thu, 25 Nov 2021 22:13:48 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1APMDmV2010066; Thu, 25 Nov 2021 22:13:48 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1APMDm1m010065; Thu, 25 Nov 2021 22:13:48 GMT (envelope-from git) Date: Thu, 25 Nov 2021 22:13:48 GMT Message-Id: <202111252213.1APMDm1m010065@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: 6f54e4c22e - main - where.html: Uncomment 12.3-STABLE snapshot URLs 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gjb X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 6f54e4c22e59dae06fb59dcbf225e64a3f30f469 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1637878429; 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; bh=D6pAQdl9QqxzSCpbf1951xnzMdCNzoOE+vIDlfA3/rI=; b=WUKD8vZ6r0BekPwl4oLiM0I7AzPVMWjo/9ZPvpigwM388i0HQEPwO7roXhcS0etga8tEGs X7eRcIq0XguuFiwVW1lM+vDOwoYNfsNarNcc78fj+ZPR5VjPO+nR40J+5sCAWoktzAmBlA kDjn/8xXYDrhbFgQXyJH2JwOlRBRciHv3Q9VAwXwGCalt4hBRJOT8PW6LEZjZ2y1sB31xy Anq1k9xg+0UZftXOADm9QgKVonOB0uUhBeVbB8PbDtv8VNfpt36kHcp1sl9PMMNRU7fjE2 t/fWxCoHBIWmCCYNOZRHSR8K7HZmiLmPxQx5VOxyQAXOHBbIX4T3Qkhh5ekSag== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1637878429; a=rsa-sha256; cv=none; b=WqH4lBT/GwT+swHTiv1iorg6z3KK/mvDaiDfU6As8d3MkTX/r8zGnzt67TNiG/K1BawjmW kq4Fn9DIUi5OzUz66pMXDaXvYwZKcp6HgLB5rcsfwgYE1u4gRD1xt5DLHaK4KZ2LeyoEUX eb0swKjP1Jm2ia8Cl1zQk+0KjKNeMmXYQZiHA7DAYl4nNqNWphwmGHeLkeiLIM85pdGCQt YqfIAj6LqYkSm9vVl43r2xgd/6uONja80YK6KtfFL+Fynsi4jmPDU0smlJIVqsZYctgvJH cWLqm/c9Lozte58RNd3dm/NhGNqOXV6x/4SlreH05i4YJpDE1q1V5CYGKXnXzQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=6f54e4c22e59dae06fb59dcbf225e64a3f30f469 commit 6f54e4c22e59dae06fb59dcbf225e64a3f30f469 Author: Glen Barber AuthorDate: 2021-11-25 22:13:20 +0000 Commit: Glen Barber CommitDate: 2021-11-25 22:13:20 +0000 where.html: Uncomment 12.3-STABLE snapshot URLs Sponsored by: Rubicon Communications, LLC ("Netgate") --- website/content/en/where.adoc | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/website/content/en/where.adoc b/website/content/en/where.adoc index 7e9406c916..c8bd3c0aac 100644 --- a/website/content/en/where.adoc +++ b/website/content/en/where.adoc @@ -283,7 +283,6 @@ a| * {blank} |=== -//// == FreeBSD {rel123-current}-STABLE [.tblbasic] @@ -326,7 +325,7 @@ a| * {blank} |=== -//// + If you plan on getting FreeBSD via HTTP or FTP, please check the listing of *link:{handbook}#mirrors-ftp[mirror sites]* in the Handbook to see if there is a site closer to you. [[install]] From nobody Fri Nov 26 07:50:34 2021 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 5A06518C5CC1 for ; Fri, 26 Nov 2021 07:50:35 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4J0n3b0bvbz4bXN; Fri, 26 Nov 2021 07:50:35 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id E8A912CDBA; Fri, 26 Nov 2021 07:50:34 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AQ7oYQR077513; Fri, 26 Nov 2021 07:50:34 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AQ7oYAL077512; Fri, 26 Nov 2021 07:50:34 GMT (envelope-from git) Date: Fri, 26 Nov 2021 07:50:34 GMT Message-Id: <202111260750.1AQ7oYAL077512@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mathieu Arnold Subject: git: efd2311b34 - main - pgp: fix my hsm key by adding cross certification, (probably) 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: mat X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: efd2311b344c458e7300a5e4aeb1d39cdc4c6702 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1637913035; 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; bh=Onkmwq4xtyN+y+pxjAF6EHgU5ZO6xMYLiMgZmrsk/Jo=; b=NINcihCJJIK78DvaG6Qg/wFTgFaCJYf6VBwrXrAsLjm/vTDkKlLjNi0k+ms4f/K7ZMevJI flXKRV8gqK3RsYMRfb0y8F2MYAA5ZPopZjJknVQFbLGfAAkqNxgfHo2aSRfI1bj+pR3XBR 7wB7oDcpRPOxIFxB8UjnnXJjRXbdg5eafjztmgPLLZNbSGIaDllq74tiCY0TFLZKEB2LwV dDNY+ctZ4RxXps4yIBBSzeM6gkTFRj1tQ2fU4HYR+fYjv9gdKiTtDlhxkDE9BeuHloXHtn NAWTBdJGP5cyvQ1RivlS3VxRyyS71hqLywWA/IfrWCOSFbj19VUfIsjTX6cdWA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1637913035; a=rsa-sha256; cv=none; b=rv+Up2e5J/jQZe5b4XUWYzbh0nHNc6zli1amWglHXrlw+HnlE/azRnB1CB43w+qiOtTTJb Rdx8/gnBMeuTqJnOBHjFBO/zIaVhk5I8Rj5d6v4Abjj4WH67f6vNY7M5bfmWWg1WDqsHAW HowJ5sEXGWRXCPeToi5PgTlzCpNxv1Y3CxvoKtN5uXAThr5fuvPtUUa0aiO1Hz0Oc20cdF 5UcJiMj4Soqogb4OVssABvThscQ7sqKU1BfjtBtaS4mGU5ITl6dqwOMhujEp7ZhcgAVqfQ Oby2+SKlxn0/mKeX0VejMqw0OXjaoJ07RhPTaIy3LLlpuY8s2SG/UJGozwJJTA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by mat: URL: https://cgit.FreeBSD.org/doc/commit/?id=efd2311b344c458e7300a5e4aeb1d39cdc4c6702 commit efd2311b344c458e7300a5e4aeb1d39cdc4c6702 Author: Mathieu Arnold AuthorDate: 2021-11-26 07:49:45 +0000 Commit: Mathieu Arnold CommitDate: 2021-11-26 07:50:23 +0000 pgp: fix my hsm key by adding cross certification, (probably) --- documentation/static/pgpkeys/mat.key | 37 +++++++++++++++++++++--------------- 1 file changed, 22 insertions(+), 15 deletions(-) diff --git a/documentation/static/pgpkeys/mat.key b/documentation/static/pgpkeys/mat.key index e8568bd954..756d31ee0f 100644 --- a/documentation/static/pgpkeys/mat.key +++ b/documentation/static/pgpkeys/mat.key @@ -2572,20 +2572,27 @@ DqLQW06p0JD69QULNUNJWAIZGSZ8KImOoy2ybwASFJU8O1VY1MOGrosPb8xPkB0A GpKsBm6ByoNMCak7I0m7AZ3f2HnSrLiH5PjODzTqwhnUbnyx1YY/8z1MXadz2xZN Rp8LOCJopPqb5e23fPPD89H/I4nNm4K/t8zy1nmk+oR7mpSLuQjE3/tQfm3BZSiS 8C8P7hprBLLpu4zFp/6uaFEn5zk+gxq6dj8fp/bVinh5+sxXih6WCnanUhPo74vW -7E0nL3WPuVDpABEBAAGJAjwEGAEKACYFCQeEzgAWIQRWHByF9F+5XS6eo7kp6wkC -kR1+AgUCYVwSrQIbDgAKCRAp6wkCkR1+AhNdD/0T+q6O8AEvhBRXlZBnvf5dWr4j -AAQ6oUGr7rNgQtpmeZ+QIN1sPpKDxJo6XuQnUm6LqvTJ7YOpYPLUOrb0kVu+j5VM -A8Si946LqTrKFIrjKqXPzdOZ8Y9JkrrW71cqAKH2h8ewlBuQwqOa2xQ7v1N4RQWm -3RPmb04asELqK6ynwJrjw4p+wjBUfVVKUJ9zVjvLyDgIP9S2g08Gz9c1Hqp1yjzQ -GX4ojouAbRmc5WFvcCT3Id/260xUEs+7jDRT08M7HMBQ1dPF0sFW2b0MLqTqwOep -0jm9PjcElrKYC+mRuZiKVcpNVgoraCxR6Tq6hgTQANPrak0Tfy0bAdsUIjRf9lpt -zRUlw2GyWh7O244c8BXsHrYz3fNBxjJXDnhm5/0y/W6oRPUUV6Ni2CvzQqsNbTuD -eehHwRY8r5GjKrOuwIfSuWhmQfxeIf8aW7NHXfIekTAs8LVF4DrFkZGmtYM2Lnnb -M9b2KEDvQJOjTK/fbf0Z5GS5qfYL5LRG1nLUZmZ9HcYRlE1skmei3qBUy0XZOm1v -J/lp1yAmIF123YtO8oW+yTtZQZis52DCtwV5PcjfeZ4IylTIRhZyT3yMFQbK0u0F -fwMOGpqMWLAEohSeX4JBhmCbPBhaT4GE0YKX+49pJYYMV7Pf0p9WIMYlLngRsj4P -ZwygmGFwKJd3prsHPg== -=IPvn +7E0nL3WPuVDpABEBAAGJA9IEGAEKACYFCQeEzgACGw4WIQRWHByF9F+5XS6eo7kp +6wkCkR1+AgUCYaCQyQGgwNQgBBkBCgB9FiEEFD4jMKwz5Ud8Ywu3ecmT/A9inX0F +AmGgkMlfFIAAAAAALgAoaXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0 +aGhvcnNlbWFuLm5ldDE0M0UyMzMwQUMzM0U1NDc3QzYzMEJCNzc5Qzk5M0ZDMEY2 +MjlEN0QACgkQecmT/A9inX1g5wgAgunL5YyH/cN83WPoL/I7J+gS9ch17efjx0RZ +ykXeji5GnlrjSiwtvtmXwniAZfapmYX4tPgTOm/hUt1s2QrOrhRi2lhqq5tqfiWK +0Lr8wpexlPWfHjyYo7rXN4aytAxv3V4wRdvyn6p53hNZU/TB7GFc+kXUJZ/D/1wW +LErnHiilnc02Uu268N38fEF/BDNQ8ToHbnYgErQPPi6RJEXX7DsGSjDjJKyJgP3C +wd7+f0Tv5/8YexcVSiLj9x4wGShqshDrkg5tDDue99p9yzsdObgzdUsX0CnP7Smh +CPfqNu024+r7dd53BZPkDm45OyoUymrxClB0e2lACU3zni7qxAkQKesJApEdfgLf +xQ//VvbIlB5midzQ4k5IR80ql4l4RgKNHJsnCWx2Xg2UoB59sc9Lr7BItVjuKrmj +YeaudkRAWMHMGRQdBgy+zNOzriMPSQR4OzAisHNrwjQEQ4ZLF3wdSgWbTHCFGeHV +oqi8+xxEcOJ4Ms+6OAnwfS9a1Tqosfu0qw18ym1jn0kPC+6rkyTya8ASVd0KYTOj +xuceVcBWJ+1xxd/rLyfa0yEtlJWMVGfdrzGeG6pRfTufHJcfsLrtL/uLOWE6KHcb +pIkVW9PXsJ4ch8podQf3CxuDoWLe5XsnXeX7cLMoXziOw9uxIslYTEJjbFXpawjr +0CcLPghAOrfdYD+tAuxXEhlubo3NgBuOlV7wJzwysxAYc9nKrIYvIDPcwhnvAsHB ++LJ8t4peLmXlg0/kgWLmK65rtqCZ0EilO5ZcAsloZYbZufmKCk01OGOmh3LmbGSQ +vK17RvyFVsCgAG2f3yiid8uemwvJgB4tSD9bPCTDq7/HRZ1H0F+23Oe1+C1ggq8d +3FwilchVLLTvHdLIGhlrnsVA9dbMCAXz5TJmxJzOClTGeD/VsXeV41xnbGChXSv2 +4TfQFVG6Ecjm+HJmqHpb8X8b8IXVnnLPnlKdsFu71vIVutpeU6bZcd/+URLV4HmB +25/bKI+XV7d6mKf/aHyEC2GoZbsYNdITByRK0Ugwbyi2VlA= +=kexe -----END PGP PUBLIC KEY BLOCK----- .... - From nobody Fri Nov 26 20:10:54 2021 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 8F47018B03C3 for ; Fri, 26 Nov 2021 20:10:54 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4J15Tp24jYz3Lj1; Fri, 26 Nov 2021 20:10:54 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 2738F6862; Fri, 26 Nov 2021 20:10:54 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AQKAsZN065735; Fri, 26 Nov 2021 20:10:54 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AQKAsBJ065734; Fri, 26 Nov 2021 20:10:54 GMT (envelope-from git) Date: Fri, 26 Nov 2021 20:10:54 GMT Message-Id: <202111262010.1AQKAsBJ065734@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 6f163cbdc2 - main - Split German porter's handbook 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 6f163cbdc275897332cddcae36a3a8f1c3237125 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1637957454; 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; bh=74/psNLoDm7UWxQTdlo1Lx7FUy3ywYF3a9cFBFL1HKs=; b=jmsYas0m/0MqAND/TlSeQ7v4BBCXppd13U/9Sh1EvLy8dG/GO+aS9dPethn/G5AsfXy9JT eUzFZnIYUvYmalWqkPzcFdaG8C1ZNnXCpuOBoz2hMYZILRRlG/nqxoHdbeRJn29hRiT0yu gTuhhMFJSQsnmB6ahlWEoJfakLqmH5QaIpVreRUHg5OLShkXbpBCAdt2Rl5ChFGI+3bOys EQbMlaZASwJy7p19Gznhzp1Fg+dnBI/Cf5eaYdTT6/aDdCAVdkoVBvos7pXfqCor3G2AVI 2yZy3E/FSnk+vgaQeDHNGtAvoHxfmJC4vPdrtn11eLsOpyYBU3a6mQE1skGNdg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1637957454; a=rsa-sha256; cv=none; b=gT3wHxCdwIamH2hm8O7zDUwLgD1OksQVPWBTfCXvxRuc1w7o5r/CfEDCUFClofdS7F5Kjp 9DG8rptazFkG8O/vjh4ZLzSvmQcV96zpnMNfwCX3RX1hXobgExwnHnmO4xSIkVbiiKeRcH ecTapTBIe/Mn6dHExtlnA4GkEtBrCHKCCI355fbZ8B/XrJ6ZwUaL3xbUQkYzAmqW36mksw dzCgBlw/yh4SQ9BioLLIl1mG3qJdgMkotSHI3DW7tcMsKMHMTYuEIg4uK6KUmCeuzjbUOD qXmJtDF9iSPepTbStrHwA25sDGi6EfbAsIzMudL1agXd3lNGr69UZKM6wfEnEg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=6f163cbdc275897332cddcae36a3a8f1c3237125 commit 6f163cbdc275897332cddcae36a3a8f1c3237125 Author: Sergio Carlavilla Delgado AuthorDate: 2021-11-26 20:10:06 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-11-26 20:10:06 +0000 Split German porter's handbook --- .../content/de/books/porters-handbook/_index.adoc | 28 ++------- .../content/de/books/porters-handbook/book.adoc | 67 ++++++++++++++++++++++ .../de/books/porters-handbook/chapters-order.adoc | 28 ++++----- .../keeping-up/{chapter.adoc => _index.adoc} | 0 .../makefile/{chapter.adoc => _index.adoc} | 4 +- .../own-port/{chapter.adoc => _index.adoc} | 2 +- .../pkg-files/{chapter.adoc => _index.adoc} | 0 .../plist/{chapter.adoc => _index.adoc} | 0 .../port-upgrading/{chapter.adoc => _index.adoc} | 4 +- .../porting-dads/{chapter.adoc => _index.adoc} | 2 +- .../porting-samplem/{chapter.adoc => _index.adoc} | 0 .../quick-porting/{chapter.adoc => _index.adoc} | 0 .../security/{chapter.adoc => _index.adoc} | 0 .../slow/{chapter.adoc => _index.adoc} | 0 .../special/{chapter.adoc => _index.adoc} | 6 +- .../testing/{chapter.adoc => _index.adoc} | 2 +- .../why-port/{chapter.adoc => _index.adoc} | 0 17 files changed, 96 insertions(+), 47 deletions(-) diff --git a/documentation/content/de/books/porters-handbook/_index.adoc b/documentation/content/de/books/porters-handbook/_index.adoc index 43795744da..e61ff38a9d 100644 --- a/documentation/content/de/books/porters-handbook/_index.adoc +++ b/documentation/content/de/books/porters-handbook/_index.adoc @@ -4,21 +4,22 @@ authors: - author: The FreeBSD Documentation Project copyright: 2000-2020 The FreeBSD Documentation Project trademarks: ["freebsd", "sun", "unix", "general"] +next: books/porters-handbook/why-port +add_single_page_link: true isIndex: true --- = FreeBSD Porter's Handbook :doctype: book :toc: macro -:toclevels: 2 +:toclevels: 1 :icons: font :sectnums: :sectnumlevels: 6 :partnums: :source-highlighter: rouge :experimental: -:book: true -:pdf: false +:images-path: books/porters-handbook/ ifdef::env-beastie[] ifdef::backend-html5[] @@ -44,23 +45,4 @@ endif::[] ''' -toc::[] - -include::{chapters-path}toc-tables.adoc[] - -include::{chapters-path}toc-examples.adoc[] - -include::{chapters-path}why-port/chapter.adoc[leveloffset=+1] -include::{chapters-path}own-port/chapter.adoc[leveloffset=+1] -include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1] -include::{chapters-path}slow/chapter.adoc[leveloffset=+1] -include::{chapters-path}makefile/chapter.adoc[leveloffset=+1] -include::{chapters-path}special/chapter.adoc[leveloffset=+1] -include::{chapters-path}plist/chapter.adoc[leveloffset=+1] -include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1] -include::{chapters-path}testing/chapter.adoc[leveloffset=+1] -include::{chapters-path}port-upgrading/chapter.adoc[leveloffset=+1] -include::{chapters-path}security/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1] -include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1] +include::{chapters-path}toc.adoc[] diff --git a/documentation/content/de/books/porters-handbook/book.adoc b/documentation/content/de/books/porters-handbook/book.adoc new file mode 100644 index 0000000000..de88775b11 --- /dev/null +++ b/documentation/content/de/books/porters-handbook/book.adoc @@ -0,0 +1,67 @@ +--- +title: FreeBSD Porter's Handbook +authors: + - author: The FreeBSD Documentation Project +copyright: 2000-2020 The FreeBSD Documentation Project +trademarks: ["freebsd", "sun", "unix", "general"] +add_split_page_link: true +--- + += FreeBSD Porter's Handbook +:doctype: book +:toc: macro +:toclevels: 2 +:icons: font +:sectnums: +:sectnumlevels: 6 +:partnums: +:source-highlighter: rouge +:experimental: +:book: true +:pdf: false + +ifdef::env-beastie[] +ifdef::backend-html5[] +include::shared/authors.adoc[] +include::shared/mirrors.adoc[] +include::shared/releases.adoc[] +include::shared/attributes/attributes-{{% lang %}}.adoc[] +include::shared/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/urls.adoc[] +:chapters-path: content/{{% lang %}}/books/porters-handbook/ +endif::[] +ifdef::backend-pdf,backend-epub3[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] +endif::[] + +ifndef::env-beastie[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] + +''' + +toc::[] + +include::{chapters-path}toc-tables.adoc[] + +include::{chapters-path}toc-examples.adoc[] + +include::{chapters-path}why-port/_index.adoc[leveloffset=+1] +include::{chapters-path}own-port/_index.adoc[leveloffset=+1] +include::{chapters-path}quick-porting/_index.adoc[leveloffset=+1] +include::{chapters-path}slow/_index.adoc[leveloffset=+1] +include::{chapters-path}makefile/_index.adoc[leveloffset=+1] +include::{chapters-path}special/_index.adoc[leveloffset=+1] +include::{chapters-path}plist/_index.adoc[leveloffset=+1] +include::{chapters-path}pkg-files/_index.adoc[leveloffset=+1] +include::{chapters-path}testing/_index.adoc[leveloffset=+1] +include::{chapters-path}port-upgrading/_index.adoc[leveloffset=+1] +include::{chapters-path}security/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-dads/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-samplem/_index.adoc[leveloffset=+1] +include::{chapters-path}keeping-up/_index.adoc[leveloffset=+1] + diff --git a/documentation/content/de/books/porters-handbook/chapters-order.adoc b/documentation/content/de/books/porters-handbook/chapters-order.adoc index 606ef5a93c..8ab4706cdf 100644 --- a/documentation/content/de/books/porters-handbook/chapters-order.adoc +++ b/documentation/content/de/books/porters-handbook/chapters-order.adoc @@ -1,14 +1,14 @@ -why-port/chapter.adoc -own-port/chapter.adoc -quick-porting/chapter.adoc -slow/chapter.adoc -makefile/chapter.adoc -special/chapter.adoc -plist/chapter.adoc -pkg-files/chapter.adoc -testing/chapter.adoc -port-upgrading/chapter.adoc -security/chapter.adoc -porting-dads/chapter.adoc -porting-samplem/chapter.adoc -keeping-up/chapter.adoc +why-port/_index.adoc +own-port/_index.adoc +quick-porting/_index.adoc +slow/_index.adoc +makefile/_index.adoc +special/_index.adoc +plist/_index.adoc +pkg-files/_index.adoc +testing/_index.adoc +port-upgrading/_index.adoc +security/_index.adoc +porting-dads/_index.adoc +porting-samplem/_index.adoc +keeping-up/_index.adoc diff --git a/documentation/content/de/books/porters-handbook/keeping-up/chapter.adoc b/documentation/content/de/books/porters-handbook/keeping-up/_index.adoc similarity index 100% rename from documentation/content/de/books/porters-handbook/keeping-up/chapter.adoc rename to documentation/content/de/books/porters-handbook/keeping-up/_index.adoc diff --git a/documentation/content/de/books/porters-handbook/makefile/chapter.adoc b/documentation/content/de/books/porters-handbook/makefile/_index.adoc similarity index 98% rename from documentation/content/de/books/porters-handbook/makefile/chapter.adoc rename to documentation/content/de/books/porters-handbook/makefile/_index.adoc index e6c81caaad..9b6ac63c44 100644 --- a/documentation/content/de/books/porters-handbook/makefile/chapter.adoc +++ b/documentation/content/de/books/porters-handbook/makefile/_index.adoc @@ -1380,7 +1380,7 @@ eine Abhängigkeit für GCC34 für jeden Port einschliesslich GCC34 selbst hinzu |Dieser Port benötigt eine bestimmte Version von `gcc` zur Erstellung. Die genaue Version kann festgelegt werden mit Werten wie `3.4`. Mit `3.4+` kann die mindestens erforderliche Version spezifiziert werden. Der `gcc` aus dem Basissystem wird genutzt, wenn er die erforderliche Version erfüllt, andernfalls wird eine geeignete Version des `gcc` aus den Ports kompiliert und die Variablen `CC` und `CXX` werden angepasst. |=== -Variablen zugehörig zu gmake und dem [.filename]#configure#-Skript werden in <> beschrieben, währenddessen autoconf, automake und libtool in <> beschrieben sind. Perl-spezifische Variablen werden in <> behandelt. X11-Variablen sind aufgelistet in <>. <> behandelt GNOME-bezogene Variablen und <> KDE-bezogene Variablen. <> dokumentiert Java-Variablen, während <>Informationen zu Apache, PHP und PEAR-Modulen enthält. Python wird in <> und Ruby in <> erörtert. <> stellt Variablen für SDL-Programme zur Verfügung und <> enthält schliesslich Variablen für Xfce. +Variablen zugehörig zu gmake und dem [.filename]#configure#-Skript werden in crossref:special[building, Build-Mechanismen] beschrieben, währenddessen autoconf, automake und libtool in crossref:special[using-autotools, Benutzung von GNU autotools] beschrieben sind. Perl-spezifische Variablen werden in crossref:special[using-perl, Die Benutzung von `perl`] behandelt. X11-Variablen sind aufgelistet in crossref:special[using-x11, Benutzung von X11]. crossref:special[using-gnome, Benutzung von GNOME] behandelt GNOME-bezogene Variablen und crossref:special[using-kde, Benutzung von KDE] KDE-bezogene Variablen. crossref:special[using-java, Benutzung von Java] dokumentiert Java-Variablen, während crossref:special[using-php, Webanwendungen, Apache und PHP]Informationen zu Apache, PHP und PEAR-Modulen enthält. Python wird in crossref:special[using-python, Python benutzen] und Ruby in crossref:special[using-ruby, Ruby benutzen] erörtert. crossref:special[using-sdl, SDL verwenden] stellt Va riablen für SDL-Programme zur Verfügung und crossref:special[using-xfce, Xfce verwenden] enthält schliesslich Variablen für Xfce. === Minimale Version einer Abhängigkeit @@ -1735,7 +1735,7 @@ Es gibt drei verschiedene Variablen, um einen Konflikt zwischen Paketen und Port [NOTE] ==== -`CONFLICTS` setzt automatisch die Variable `IGNORE`, die ausführlicher in <> beschrieben wird. +`CONFLICTS` setzt automatisch die Variable `IGNORE`, die ausführlicher in crossref:porting-dads[dads-noinstall, Einen Port durch `BROKEN` - `FORBIDDEN` oder `IGNORE` als nicht installierbar markieren] beschrieben wird. ==== Beim Entfernen eines von mehreren in Konflikt stehenden Ports ist es ratsam, die `CONFLICTS`-Einträge in den anderen Ports für einige Monate beizubehalten, um Nutzer zu unterstützen, die ihre Ports nur sporadisch aktualisieren. diff --git a/documentation/content/de/books/porters-handbook/own-port/chapter.adoc b/documentation/content/de/books/porters-handbook/own-port/_index.adoc similarity index 94% rename from documentation/content/de/books/porters-handbook/own-port/chapter.adoc rename to documentation/content/de/books/porters-handbook/own-port/_index.adoc index 42a774de4e..35fdad8270 100644 --- a/documentation/content/de/books/porters-handbook/own-port/chapter.adoc +++ b/documentation/content/de/books/porters-handbook/own-port/_index.adoc @@ -44,7 +44,7 @@ endif::[] Sie sind also daran interessiert, einen neuen Port zu erstellen oder einen vorhandenen zu aktualisieren? Großartig! -Die folgenden Kapitel beinhalten einige Richtlinien, um einen neuen Port für FreeBSD zu erstellen. Wenn Sie einen vorhandenen Port auf den neuesten Stand bringen wollen, sollten Sie mit <> fortfahren. +Die folgenden Kapitel beinhalten einige Richtlinien, um einen neuen Port für FreeBSD zu erstellen. Wenn Sie einen vorhandenen Port auf den neuesten Stand bringen wollen, sollten Sie mit crossref:port-upgrading[port-upgrading, Einen existierenden Port aktualisieren] fortfahren. Wenn Ihnen dieses Dokument nicht detailliert genug ist, sollten Sie einen Blick in [.filename]#/usr/ports/Mk/bsd.port.mk# werfen. Das Makefile jedes Ports bindet diese Datei ein. Auch wenn Sie nicht täglich mit Makefiles arbeiten, sollten Sie gut damit zurecht kommen, da die Datei gut dokumentiert ist und Sie eine Menge Wissen daraus erlangen können. Zusätzlich können Sie speziellere Fragen an die {freebsd-ports}-Mailingliste stellen. diff --git a/documentation/content/de/books/porters-handbook/pkg-files/chapter.adoc b/documentation/content/de/books/porters-handbook/pkg-files/_index.adoc similarity index 100% rename from documentation/content/de/books/porters-handbook/pkg-files/chapter.adoc rename to documentation/content/de/books/porters-handbook/pkg-files/_index.adoc diff --git a/documentation/content/de/books/porters-handbook/plist/chapter.adoc b/documentation/content/de/books/porters-handbook/plist/_index.adoc similarity index 100% rename from documentation/content/de/books/porters-handbook/plist/chapter.adoc rename to documentation/content/de/books/porters-handbook/plist/_index.adoc diff --git a/documentation/content/de/books/porters-handbook/port-upgrading/chapter.adoc b/documentation/content/de/books/porters-handbook/port-upgrading/_index.adoc similarity index 97% rename from documentation/content/de/books/porters-handbook/port-upgrading/chapter.adoc rename to documentation/content/de/books/porters-handbook/port-upgrading/_index.adoc index 1acc172e34..f3ff518c1a 100644 --- a/documentation/content/de/books/porters-handbook/port-upgrading/chapter.adoc +++ b/documentation/content/de/books/porters-handbook/port-upgrading/_index.adoc @@ -79,7 +79,7 @@ Wenn Sie Ihre Aktualisierung aufgrund von Sicherheitsbedenken oder eines schwerw Noch einmal: Bitte verwenden Sie man:diff[1] und nicht man:shar[1], um Aktualisierungen existierender Ports zu senden. Sie erleichtern es damit den Ports-Committern, Ihre Änderungen nachzuvollziehen. ==== -Nun, da Sie all das geschafft haben, können Sie in <> nachlesen, wie Sie den Port aktuell halten. +Nun, da Sie all das geschafft haben, können Sie in crossref:keeping-up[keeping-up, Auf dem Laufenden bleiben] nachlesen, wie Sie den Port aktuell halten. [[cvs-diff]] == Patches mit CVS erstellen @@ -107,7 +107,7 @@ Danach modifizieren Sie den Port in gewohnter Weise. Falls Sie Dateien hinzufüg % cvs remove deleted_file .... -Überprüfen Sie die Funktion Ihres Ports anhand der Checklisten in <> und <>. +Überprüfen Sie die Funktion Ihres Ports anhand der Checklisten in crossref:quick-porting[porting-testing, Den Port testen] und crossref:quick-porting[porting-portlint,Ihren Port mit `portlint` überprüfen]. [source,shell] .... diff --git a/documentation/content/de/books/porters-handbook/porting-dads/chapter.adoc b/documentation/content/de/books/porters-handbook/porting-dads/_index.adoc similarity index 99% rename from documentation/content/de/books/porters-handbook/porting-dads/chapter.adoc rename to documentation/content/de/books/porters-handbook/porting-dads/_index.adoc index 09279e202a..6853f0ec12 100644 --- a/documentation/content/de/books/porters-handbook/porting-dads/chapter.adoc +++ b/documentation/content/de/books/porters-handbook/porting-dads/_index.adoc @@ -2723,7 +2723,7 @@ Es gibt keine Vorschrift wie lange die Vorwarnzeit sein muss. Gegenwärtig ist e Der korrekte Weg eines [.filename]#Makefile# anzuzeigen, dass der Port aufgrund eines externen Grundes nicht installiert werden kann (zum Beispiel, weil der Benutzer eine ungültige Kombination von Build-Optionen angegeben hat), ist `IGNORE` auf einen nicht leeren Wert zu setzen. Dieser wird dann formatiert und dem Benutzer von `make install` ausgegeben. -Es ist ein verbreiteter Fehler `.error` für diesem Zweck zu verwenden. Das Problem dabei ist, dass viele automatisierte Werkzeuge, die mit dem Ports-Baum arbeiten, in dieser Situation fehlschlagen. Am Häufigsten tritt das Problem beim Versuch [.filename]#/usr/ports/INDEX# zu bauen auf (siehe <>). Jedoch schlagen auch trivialere Befehle wie `make maintainer` in diesem Fall fehl. Dies ist nicht akzeptabel! +Es ist ein verbreiteter Fehler `.error` für diesem Zweck zu verwenden. Das Problem dabei ist, dass viele automatisierte Werkzeuge, die mit dem Ports-Baum arbeiten, in dieser Situation fehlschlagen. Am Häufigsten tritt das Problem beim Versuch [.filename]#/usr/ports/INDEX# zu bauen auf (siehe crossref:testing[make-describe, `make describe` ausführen]). Jedoch schlagen auch trivialere Befehle wie `make maintainer` in diesem Fall fehl. Dies ist nicht akzeptabel! [[dot-error-breaks-index]] .Wie vermeidet man die Verwendung von `.error` diff --git a/documentation/content/de/books/porters-handbook/porting-samplem/chapter.adoc b/documentation/content/de/books/porters-handbook/porting-samplem/_index.adoc similarity index 100% rename from documentation/content/de/books/porters-handbook/porting-samplem/chapter.adoc rename to documentation/content/de/books/porters-handbook/porting-samplem/_index.adoc diff --git a/documentation/content/de/books/porters-handbook/quick-porting/chapter.adoc b/documentation/content/de/books/porters-handbook/quick-porting/_index.adoc similarity index 100% rename from documentation/content/de/books/porters-handbook/quick-porting/chapter.adoc rename to documentation/content/de/books/porters-handbook/quick-porting/_index.adoc diff --git a/documentation/content/de/books/porters-handbook/security/chapter.adoc b/documentation/content/de/books/porters-handbook/security/_index.adoc similarity index 100% rename from documentation/content/de/books/porters-handbook/security/chapter.adoc rename to documentation/content/de/books/porters-handbook/security/_index.adoc diff --git a/documentation/content/de/books/porters-handbook/slow/chapter.adoc b/documentation/content/de/books/porters-handbook/slow/_index.adoc similarity index 100% rename from documentation/content/de/books/porters-handbook/slow/chapter.adoc rename to documentation/content/de/books/porters-handbook/slow/_index.adoc diff --git a/documentation/content/de/books/porters-handbook/special/chapter.adoc b/documentation/content/de/books/porters-handbook/special/_index.adoc similarity index 99% rename from documentation/content/de/books/porters-handbook/special/chapter.adoc rename to documentation/content/de/books/porters-handbook/special/_index.adoc index 36a48ca28a..8af1f93de0 100644 --- a/documentation/content/de/books/porters-handbook/special/chapter.adoc +++ b/documentation/content/de/books/porters-handbook/special/_index.adoc @@ -967,7 +967,7 @@ Zusätzlich sind die folgenden Konstanten definiert, damit alle Java-Ports auf e |Das Verzeichnis, in dem JAR-Dateien, die von anderen Ports installiert wurden, liegen. Standardmäßig [.filename]#${LOCALBASE}/shared/java/classes#. |=== -Die entsprechenden Einträge sind sowohl in `PLIST_SUB` (dokumentiert in <>) als auch in `SUB_LIST` definiert. +Die entsprechenden Einträge sind sowohl in `PLIST_SUB` (dokumentiert in crossref:plist[plist-sub,Änderungen an pkg-plist mit Hilfe von make-Variablen]) als auch in `SUB_LIST` definiert. [[java-building-with-ant]] === Kompilieren mit Ant @@ -988,7 +988,7 @@ Beim Portieren einer Java-Applikation installiert der Port normalerweise alles u Unabhängig von der Art Ihres Ports (Bibliothek oder Applikation), sollte die zusätzliche Dokumentation an die <> installiert werden wie bei jedem anderen Port auch. Das JavaDoc-Werkzeug ist dafür bekannt einen unterschiedlichen Satz von Dateien abhängig von der Version des benutzten JDKs zu erstellen. Für Ports, die nicht die Benutzung eines bestimmten JDKs vorgeben, ist es deshalb eine komplexe Aufgabe die Packliste ([.filename]#pkg-plist#) festzulegen. Dies ist ein Grund, warum dringend angeraten wird, das `PORTDOCS`-Makro zu benutzen. Außerdem, selbst wenn Sie den Satz von Dateien, den `javadoc` erzeugen wird, voraussagen können, die Größe der resultierenden [.filename]#pkg-plist# befürwortet die Benutzung von `PORTDOCS`. -Der Vorgabewert für `DATADIR` ist [.filename]#${PREFIX}/shared/${PORTNAME}#. Es ist eine gute Idee, `DATADIR` für Java-Ports stattdessen auf [.filename]#${JAVASHAREDIR}/${PORTNAME}# zu setzen. In der Tat wird `DATADIR` automatisch zu `PLIST_SUB` (dokumentiert in <>) hinzugefügt, d.h. Sie können `%%DATADIR%%` direkt in [.filename]#pkg-plist# benutzen. +Der Vorgabewert für `DATADIR` ist [.filename]#${PREFIX}/shared/${PORTNAME}#. Es ist eine gute Idee, `DATADIR` für Java-Ports stattdessen auf [.filename]#${JAVASHAREDIR}/${PORTNAME}# zu setzen. In der Tat wird `DATADIR` automatisch zu `PLIST_SUB` (dokumentiert in crossref:plist[plist-sub,Änderungen an pkg-plist mit Hilfe von make-Variablen]) hinzugefügt, d.h. Sie können `%%DATADIR%%` direkt in [.filename]#pkg-plist# benutzen. Zu der Frage, ob Java-Ports aus dem Quelltext gebaut werden, oder direkt bereitgestellte binäre Distributionen benutzt werden sollten, gab es, als dies geschrieben wurde, keine definierte Richtlinie. Allerdings ermutigen Mitglieder des http://www.freebsd.org/java/[FreeBSD Java-Projekts] Porter dazu, Ihre Ports aus dem Quelltext kompilieren zu lassen, wann immer dies kein Problem darstellt. @@ -996,7 +996,7 @@ Alle Eigenschaften, die in diesem Abschnitt präsentiert wurden sind in [.filena Obwohl es eine `java`-Kategorie für Fehlerberichte gibt, bezieht sich diese auf die JDK-Portierungsbemühungen des FreeBSD Java-Projektes. Deshalb sollten Sie Ihren Java-Port in der `ports`-Kategorie einreichen wie bei jeden anderen Port auch - es sei denn, die Angelegenheit, die Sie zu klären versuchen, steht in Zusammenhang entweder mit einer JDK-Implementierung oder [.filename]#bsd.java.mk#. -Gleichermaßen gibt es eine definierte Richtlinie für die `CATEGORIES` eines Java-Ports, die in <> erklärt wird. +Gleichermaßen gibt es eine definierte Richtlinie für die `CATEGORIES` eines Java-Ports, die in crossref:flavors[makefile-categories, Kategorisierung] erklärt wird. [[using-php]] == Webanwendungen, Apache und PHP diff --git a/documentation/content/de/books/porters-handbook/testing/chapter.adoc b/documentation/content/de/books/porters-handbook/testing/_index.adoc similarity index 98% rename from documentation/content/de/books/porters-handbook/testing/chapter.adoc rename to documentation/content/de/books/porters-handbook/testing/_index.adoc index c9d3cda064..5213ae7b86 100644 --- a/documentation/content/de/books/porters-handbook/testing/chapter.adoc +++ b/documentation/content/de/books/porters-handbook/testing/_index.adoc @@ -49,7 +49,7 @@ Einige der FreeBSD-Werkzeuge zur Pflege von Ports, wie zum Beispiel man:portupgr [NOTE] ==== -Es ist wichtig diese Datei erzeugen zu können, unabhängig davon, welche Optionen in [.filename]#make.conf# vorhanden sind. Bitte vermeiden Sie es daher beispielsweise `.error`-Anweisungen zu benutzen, wenn zum Beispiel eine Abhängigkeit nicht erfüllt wird (Lesen Sie dazu bitte <>). +Es ist wichtig diese Datei erzeugen zu können, unabhängig davon, welche Optionen in [.filename]#make.conf# vorhanden sind. Bitte vermeiden Sie es daher beispielsweise `.error`-Anweisungen zu benutzen, wenn zum Beispiel eine Abhängigkeit nicht erfüllt wird (Lesen Sie dazu bitte crossref:porting-dads[dads-dot-error,Vermeiden Sie den Gebrauch des `.error`-Konstruktes]). ==== Wenn `make describe` eine Zeichenkette anstatt einer Fehlermeldung erzeugt, sind Sie wahrscheinlich auf der sicheren Seite. Vergleichen Sie die erzeugte Zeichenkette mit [.filename]#bsd.port.mk#, um mehr über deren Bedeutung zu erfahren. diff --git a/documentation/content/de/books/porters-handbook/why-port/chapter.adoc b/documentation/content/de/books/porters-handbook/why-port/_index.adoc similarity index 100% rename from documentation/content/de/books/porters-handbook/why-port/chapter.adoc rename to documentation/content/de/books/porters-handbook/why-port/_index.adoc From nobody Fri Nov 26 20:39:33 2021 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 114AD18BDD9A for ; Fri, 26 Nov 2021 20:39:34 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4J166s5Ks7z3lVv; Fri, 26 Nov 2021 20:39:33 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 861567577; Fri, 26 Nov 2021 20:39:33 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AQKdXbi096968; Fri, 26 Nov 2021 20:39:33 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AQKdXRJ096967; Fri, 26 Nov 2021 20:39:33 GMT (envelope-from git) Date: Fri, 26 Nov 2021 20:39:33 GMT Message-Id: <202111262039.1AQKdXRJ096967@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: e82f4427f5 - main - Split Japanese porter's handbook 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e82f4427f55f4b567dd367a58065301400de5609 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1637959173; 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; bh=DI6Uw7riPy0mr3FHHSGVhr7VLXRIJrPeGbld7Qp4A6M=; b=LQ3nzyQyo9iihggDJX+3gr3vaMGTGLU8v9PmDmAD42++ALjfNNHZZSM/YSFdxOLuq7QF7O Z5vBRyOndqlG8hjDCQaDg9c7UbeUrPTFCCTUG0O9VtoWpkWGsuAKiXwdyD545sfz/Y1FWv QAaDaBWpMQKb+yhTeLUi8RUWB6nN/oUXDUmUYqFof6J8gx7MM2u6Gy+zA+/rQDD8yfXnpy 3CxOiJISZMQVREGxmibrKjvJOaEtU2NuT+aHQSR7fXd16KHwjPaBEWU35OOfA0qIofQW33 PwR96YKOHcJZicrOHc2kJ2R0b6P4vRa51pfQp8VkDfkdcfOOjpZLk/WOgyKhxA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1637959173; a=rsa-sha256; cv=none; b=nm31jPsdUtxlVG7Z41jPiidK3o8ShsWWerKoJTtIfQ8WBwp5hKqZtyFHJvTdRe8a14eOQL H+Dom3/pmNi1fdZCILQJAGOxHRWxWlcsRuIh7F/9vTYuYepk7buTUMC0/I/z9i7jsO+4/r QFPeYcwFUOrjDa//GE42wStj3L4+51VC+1kkxh0JtQbn3kY4TwWNtAbrqwPReAraXM+i0s pCLCREO+Ld0OvgOLxxeaJxZy5ZEV+Q0qL9p2LOvJqbT+EJu5y4CA3rWZHfw+3uYdjM+u3g J6B2pjOWnfgal28/fRBbGuXiKlAtCKtzPzZIrDI5bGdna9O0zJE7wwRxTUXL/A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=e82f4427f55f4b567dd367a58065301400de5609 commit e82f4427f55f4b567dd367a58065301400de5609 Author: Sergio Carlavilla Delgado AuthorDate: 2021-11-26 20:39:07 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-11-26 20:39:07 +0000 Split Japanese porter's handbook --- .../content/ja/books/porters-handbook/_index.adoc | 33 ++------- .../content/ja/books/porters-handbook/book.adoc | 78 ++++++++++++++++++++++ .../changes/{chapter.adoc => _index.adoc} | 0 .../ja/books/porters-handbook/chapters-order.adoc | 38 +++++------ .../makefile/{chapter.adoc => _index.adoc} | 12 ++-- .../own-port/{chapter.adoc => _index.adoc} | 2 +- .../pkg-files/{chapter.adoc => _index.adoc} | 0 .../port-upgrading/{chapter.adoc => _index.adoc} | 0 .../{chapter.adoc => _index.adoc} | 0 .../porting-dads/{chapter.adoc => _index.adoc} | 0 .../porting-info/{chapter.adoc => _index.adoc} | 0 .../porting-manpages/{chapter.adoc => _index.adoc} | 0 .../{chapter.adoc => _index.adoc} | 0 .../porting-motif/{chapter.adoc => _index.adoc} | 0 .../porting-samplem/{chapter.adoc => _index.adoc} | 0 .../quick-porting/{chapter.adoc => _index.adoc} | 0 .../shared/{chapter.adoc => _index.adoc} | 0 .../slow/{chapter.adoc => _index.adoc} | 0 .../special/{chapter.adoc => _index.adoc} | 0 .../testing/{chapter.adoc => _index.adoc} | 0 .../why-port/{chapter.adoc => _index.adoc} | 0 .../x11-fonts/{chapter.adoc => _index.adoc} | 0 22 files changed, 111 insertions(+), 52 deletions(-) diff --git a/documentation/content/ja/books/porters-handbook/_index.adoc b/documentation/content/ja/books/porters-handbook/_index.adoc index 280eb91b6c..80e1b593df 100644 --- a/documentation/content/ja/books/porters-handbook/_index.adoc +++ b/documentation/content/ja/books/porters-handbook/_index.adoc @@ -4,21 +4,22 @@ authors: - author: FreeBSD ドキュメンテーションプロジェクト copyright: 2000-2020 The FreeBSD Documentation Project trademarks: ["freebsd", "sun", "unix", "general"] +next: books/porters-handbook/why-port +add_single_page_link: true isIndex: true --- -= FreeBSD port 作成者のためのハンドブック += FreeBSD Porter's Handbook :doctype: book :toc: macro -:toclevels: 2 +:toclevels: 1 :icons: font :sectnums: :sectnumlevels: 6 :partnums: :source-highlighter: rouge :experimental: -:book: true -:pdf: false +:images-path: books/porters-handbook/ ifdef::env-beastie[] ifdef::backend-html5[] @@ -53,26 +54,6 @@ endif::[] ''' -toc::[] +include::{chapters-path}toc.adoc[] -include::{chapters-path}toc-examples.adoc[] - -include::{chapters-path}why-port/chapter.adoc[leveloffset=+1] -include::{chapters-path}own-port/chapter.adoc[leveloffset=+1] -include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1] -include::{chapters-path}slow/chapter.adoc[leveloffset=+1] -include::{chapters-path}makefile/chapter.adoc[leveloffset=+1] -include::{chapters-path}special/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-masterdir/chapter.adoc[leveloffset=+1] -include::{chapters-path}shared/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-manpages/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-motif/chapter.adoc[leveloffset=+1] -include::{chapters-path}x11-fonts/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-info/chapter.adoc[leveloffset=+1] -include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1] -include::{chapters-path}testing/chapter.adoc[leveloffset=+1] -include::{chapters-path}port-upgrading/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-autoplist/chapter.adoc[leveloffset=+1] -include::{chapters-path}changes/chapter.adoc[leveloffset=+1] +include::{chapters-path}toc-examples.adoc[] diff --git a/documentation/content/ja/books/porters-handbook/book.adoc b/documentation/content/ja/books/porters-handbook/book.adoc new file mode 100644 index 0000000000..3e4af86dff --- /dev/null +++ b/documentation/content/ja/books/porters-handbook/book.adoc @@ -0,0 +1,78 @@ +--- +title: FreeBSD port 作成者のためのハンドブック +authors: + - author: FreeBSD ドキュメンテーションプロジェクト +copyright: 2000-2020 The FreeBSD Documentation Project +trademarks: ["freebsd", "sun", "unix", "general"] +add_split_page_link: true +--- + += FreeBSD Porter's Handbook +:doctype: book +:toc: macro +:toclevels: 2 +:icons: font +:sectnums: +:sectnumlevels: 6 +:partnums: +:source-highlighter: rouge +:experimental: +:book: true +:pdf: false + +ifdef::env-beastie[] +ifdef::backend-html5[] +include::shared/authors.adoc[] +include::shared/mirrors.adoc[] +include::shared/releases.adoc[] +include::shared/attributes/attributes-{{% lang %}}.adoc[] +include::shared/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/urls.adoc[] +:chapters-path: content/{{% lang %}}/books/porters-handbook/ +endif::[] +ifdef::backend-pdf,backend-epub3[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] +endif::[] + +ifndef::env-beastie[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] + +[.abstract-title] +概要 + +このハンドブックは FreeBSD の port 作成者 (porter) 向けに、 具体的な port の作成方法や注意点などをまとめたものです。 + +日本語版の作成は FreeBSD 日本語ドキュメンテーション プロジェクト (FreeBSD doc-jp) が行なっています。 日本語訳および、日本語版のみに関することは FreeBSD 日本語ドキュメンテーションプロジェクト に おいて日本語で議論されています。 + +文書の日本語訳に関するお問い合わせや、 文書の原文に関する問い合わせをしたいが英語が得意でないという方は、 FreeBSD 日本語ドキュメンテーションプロジェクト まで日本語でコメントをお寄せください。 + +''' + +toc::[] + +include::{chapters-path}toc-examples.adoc[] + +include::{chapters-path}why-port/_index.adoc[leveloffset=+1] +include::{chapters-path}own-port/_index.adoc[leveloffset=+1] +include::{chapters-path}quick-porting/_index.adoc[leveloffset=+1] +include::{chapters-path}slow/_index.adoc[leveloffset=+1] +include::{chapters-path}makefile/_index.adoc[leveloffset=+1] +include::{chapters-path}special/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-masterdir/_index.adoc[leveloffset=+1] +include::{chapters-path}shared/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-manpages/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-motif/_index.adoc[leveloffset=+1] +include::{chapters-path}x11-fonts/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-info/_index.adoc[leveloffset=+1] +include::{chapters-path}pkg-files/_index.adoc[leveloffset=+1] +include::{chapters-path}testing/_index.adoc[leveloffset=+1] +include::{chapters-path}port-upgrading/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-dads/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-samplem/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-autoplist/_index.adoc[leveloffset=+1] +include::{chapters-path}changes/_index.adoc[leveloffset=+1] diff --git a/documentation/content/ja/books/porters-handbook/changes/chapter.adoc b/documentation/content/ja/books/porters-handbook/changes/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/changes/chapter.adoc rename to documentation/content/ja/books/porters-handbook/changes/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/chapters-order.adoc b/documentation/content/ja/books/porters-handbook/chapters-order.adoc index 6ae8298094..52b1571174 100644 --- a/documentation/content/ja/books/porters-handbook/chapters-order.adoc +++ b/documentation/content/ja/books/porters-handbook/chapters-order.adoc @@ -1,19 +1,19 @@ -why-port/chapter.adoc -own-port/chapter.adoc -quick-porting/chapter.adoc -slow/chapter.adoc -makefile/chapter.adoc -special/chapter.adoc -porting-masterdir/chapter.adoc -shared/chapter.adoc -porting-manpages/chapter.adoc -porting-motif/chapter.adoc -x11-fonts/chapter.adoc -porting-info/chapter.adoc -pkg-files/chapter.adoc -testing/chapter.adoc -port-upgrading/chapter.adoc -porting-dads/chapter.adoc -porting-samplem/chapter.adoc -porting-autoplist/chapter.adoc -changes/chapter.adoc +why-port/_index.adoc +own-port/_index.adoc +quick-porting/_index.adoc +slow/_index.adoc +makefile/_index.adoc +special/_index.adoc +porting-masterdir/_index.adoc +shared/_index.adoc +porting-manpages/_index.adoc +porting-motif/_index.adoc +x11-fonts/_index.adoc +porting-info/_index.adoc +pkg-files/_index.adoc +testing/_index.adoc +port-upgrading/_index.adoc +porting-dads/_index.adoc +porting-samplem/_index.adoc +porting-autoplist/_index.adoc +changes/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/makefile/chapter.adoc b/documentation/content/ja/books/porters-handbook/makefile/_index.adoc similarity index 99% rename from documentation/content/ja/books/porters-handbook/makefile/chapter.adoc rename to documentation/content/ja/books/porters-handbook/makefile/_index.adoc index cf4c25d1e4..a084f9a942 100644 --- a/documentation/content/ja/books/porters-handbook/makefile/chapter.adoc +++ b/documentation/content/ja/books/porters-handbook/makefile/_index.adoc @@ -1193,19 +1193,19 @@ EXTRACT_DEPENDS= |その port をビルドするのに `gmake` が必要です。 |`USE_PERL5` -|その port をビルドしてインストールするのに `perl 5` が必要です。 `perl` に関連して設定可能な他の変数については <> をご覧ください。 +|その port をビルドしてインストールするのに `perl 5` が必要です。 `perl` に関連して設定可能な他の変数については crossref:special[using-perl, perl の利用] をご覧ください。 |`USE_X_PREFIX` -|その port は `PREFIX` ではなく `X11BASE` にインストールされます。 X11 に関連して設定可能な他の変数については、 <> をご覧ください。 +|その port は `PREFIX` ではなく `X11BASE` にインストールされます。 X11 に関連して設定可能な他の変数については、 crossref:special[using-x11, X11 の利用] をご覧ください。 |`USE_AUTOMAKE` -|その port のビルドに GNU `automake` が使われます。`automake` に関わる他に設定可能な変数については、 <> をご覧ください。 +|その port のビルドに GNU `automake` が使われます。`automake` に関わる他に設定可能な変数については、 crossref:special[using-automake, `automake` - `autoconf` および libtool の利用] をご覧ください。 |`USE_AUTOCONF` -|その port のビルドに GNU `autoconf` が使われます。`autoconf` に関わる他に設定可能な変数については、 <> をご覧ください。 +|その port のビルドに GNU `autoconf` が使われます。`autoconf` に関わる他に設定可能な変数については、 crossref:special[using-automake, `automake` - `autoconf` および libtool の利用] をご覧ください。 |`USE_LIBTOOL` -|その port のビルドに GNU `libtool` が使われます。`libtool` に関わる他に設定可能な変数については、 <> をご覧ください。 +|その port のビルドに GNU `libtool` が使われます。`libtool` に関わる他に設定可能な変数については、 crossref:special[using-automake, `automake` - `autoconf` および libtool の利用] をご覧ください。 |`GMAKE` |`gmake` が `PATH` に入っていない場合のフルパス @@ -1214,7 +1214,7 @@ EXTRACT_DEPENDS= |その port のビルドに `bison` が使われます。 |`USE_SDL` -|その port のビルドや実行に `SDL` が使われます。 `USE_SDL` の使い方について、詳しくは <> をご覧ください。 +|その port のビルドや実行に `SDL` が使われます。 `USE_SDL` の使い方について、詳しくは crossref:special[using-sdl,SDL の利用] をご覧ください。 |`NO_INSTALL_MANPAGES` |`install.man` ターゲットを使いません。 diff --git a/documentation/content/ja/books/porters-handbook/own-port/chapter.adoc b/documentation/content/ja/books/porters-handbook/own-port/_index.adoc similarity index 95% rename from documentation/content/ja/books/porters-handbook/own-port/chapter.adoc rename to documentation/content/ja/books/porters-handbook/own-port/_index.adoc index 3a18b9b46b..6a4eef7762 100644 --- a/documentation/content/ja/books/porters-handbook/own-port/chapter.adoc +++ b/documentation/content/ja/books/porters-handbook/own-port/_index.adoc @@ -44,7 +44,7 @@ endif::[] 自分で port を作ることや、既存の port の 更新作業に興味があるのですか。それはすばらしい! -ここでは FreeBSD 用の port を作る際の ガイドラインをいくつか示します。 既存の port を更新したいと考えている場合であっても、 まずこの章を読んでから、次に <> を読むようにしてください。 +ここでは FreeBSD 用の port を作る際の ガイドラインをいくつか示します。 既存の port を更新したいと考えている場合であっても、 まずこの章を読んでから、次に crossref:port-upgrading[port-upgrading, アップグレード] を読むようにしてください。 この文書では充分に詳細がわからない場合には、 [.filename]#/usr/ports/Mk/bsd.port.mk# を参照してください。 このファイルは、port の Makefile が例外なくインクルードしているものです。 これには細かくコメントが書かれていますので、Makefile を読むのに あまり慣れていない人でも、たくさんの情報を得ることができるでしょう。 それでも解決できないような質問は、link:{freebsd-ports} にポストしてみるのも 良いでしょう。 diff --git a/documentation/content/ja/books/porters-handbook/pkg-files/chapter.adoc b/documentation/content/ja/books/porters-handbook/pkg-files/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/pkg-files/chapter.adoc rename to documentation/content/ja/books/porters-handbook/pkg-files/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/port-upgrading/chapter.adoc b/documentation/content/ja/books/porters-handbook/port-upgrading/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/port-upgrading/chapter.adoc rename to documentation/content/ja/books/porters-handbook/port-upgrading/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/porting-autoplist/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-autoplist/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/porting-autoplist/chapter.adoc rename to documentation/content/ja/books/porters-handbook/porting-autoplist/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/porting-dads/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-dads/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/porting-dads/chapter.adoc rename to documentation/content/ja/books/porters-handbook/porting-dads/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/porting-info/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-info/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/porting-info/chapter.adoc rename to documentation/content/ja/books/porters-handbook/porting-info/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/porting-manpages/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-manpages/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/porting-manpages/chapter.adoc rename to documentation/content/ja/books/porters-handbook/porting-manpages/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/porting-masterdir/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-masterdir/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/porting-masterdir/chapter.adoc rename to documentation/content/ja/books/porters-handbook/porting-masterdir/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/porting-motif/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-motif/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/porting-motif/chapter.adoc rename to documentation/content/ja/books/porters-handbook/porting-motif/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/porting-samplem/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-samplem/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/porting-samplem/chapter.adoc rename to documentation/content/ja/books/porters-handbook/porting-samplem/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/quick-porting/chapter.adoc b/documentation/content/ja/books/porters-handbook/quick-porting/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/quick-porting/chapter.adoc rename to documentation/content/ja/books/porters-handbook/quick-porting/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/shared/chapter.adoc b/documentation/content/ja/books/porters-handbook/shared/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/shared/chapter.adoc rename to documentation/content/ja/books/porters-handbook/shared/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/slow/chapter.adoc b/documentation/content/ja/books/porters-handbook/slow/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/slow/chapter.adoc rename to documentation/content/ja/books/porters-handbook/slow/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/special/chapter.adoc b/documentation/content/ja/books/porters-handbook/special/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/special/chapter.adoc rename to documentation/content/ja/books/porters-handbook/special/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/testing/chapter.adoc b/documentation/content/ja/books/porters-handbook/testing/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/testing/chapter.adoc rename to documentation/content/ja/books/porters-handbook/testing/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/why-port/chapter.adoc b/documentation/content/ja/books/porters-handbook/why-port/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/why-port/chapter.adoc rename to documentation/content/ja/books/porters-handbook/why-port/_index.adoc diff --git a/documentation/content/ja/books/porters-handbook/x11-fonts/chapter.adoc b/documentation/content/ja/books/porters-handbook/x11-fonts/_index.adoc similarity index 100% rename from documentation/content/ja/books/porters-handbook/x11-fonts/chapter.adoc rename to documentation/content/ja/books/porters-handbook/x11-fonts/_index.adoc From nobody Fri Nov 26 23:24:39 2021 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 0257D18A7DC1 for ; Fri, 26 Nov 2021 23:24:40 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4J19nM4rMjz3PDV; Fri, 26 Nov 2021 23:24:39 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 7E52F11A23; Fri, 26 Nov 2021 23:24:39 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1AQNOdZA023985; Fri, 26 Nov 2021 23:24:39 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1AQNOdsv023984; Fri, 26 Nov 2021 23:24:39 GMT (envelope-from git) Date: Fri, 26 Nov 2021 23:24:39 GMT Message-Id: <202111262324.1AQNOdsv023984@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: bea2fef3f0 - main - Split Brazilian porter's handbook and fix link in English porter's 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: bea2fef3f080975d594dddade67fd0018d3d7440 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1637969079; 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; bh=UsOFVu2/9pcDQdMCWe+FFsnJcZtIhe5sRV46OflCBrY=; b=S+Pz+JJydPRMtn8ypY87EvavDpU6YQxxLWVrnDtDHLP4C2lkyHTTmu1wVDdxOGLXy+WgQ9 FoHQoQWvo7Lh1yg07WY11vPKHyb9uE7CYyJh4djncD31fKe2WHZbj1zopAp3pqc/yrUaIF K74NhCBpVXnoAIYhgAzYJz89guP+8/mEyWPkBuc5v0rRdF0P3wsEmBtsLd0klA936ol+li izuuIKaStxJQ0LgywSZ0bvQ9P5pxQ/D3KMx7AaAjJPMRpaNTc66uKRmE5gS4B5SwBj8oD6 idgddQg5k/Lva+/phntiLNPngSmuSDyxwVDVybcr7nnru35hJ9F31TqLQtyT7w== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1637969079; a=rsa-sha256; cv=none; b=PyJ11Nx5bkon3U7hp5QDma1AKY8okXEJAxxmiqFhcoxnwe4kOS6iRTP+zN0hrktTyaaUJK Km34E1bjrvs6eWNTJTaHip17U4rkryy7ey+9DjKQCV1TuxmujKtO3bQjvCHaqebI3gm0j2 /V3PL0rzx/YsOqX/lq+QQ8EmHEmVpkWqvWuxxd3xLoR9mC+UgrS+54hUVJ3+Lnu+lhEFKE WXJbaBABAqNqbGWCGycziA0w80bn+eXHo8PJn7nsnwoNMJyt9fg4myI+CYMSroMI8yNDeZ A0hClMCRlGlT9m/mR+NQkF01jjPSJnHCNgQjrKakK1l/EsLZtqziWsupQj++Gw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=bea2fef3f080975d594dddade67fd0018d3d7440 commit bea2fef3f080975d594dddade67fd0018d3d7440 Author: Sergio Carlavilla Delgado AuthorDate: 2021-11-26 23:23:59 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-11-26 23:23:59 +0000 Split Brazilian porter's handbook and fix link in English porter's --- .../en/books/porters-handbook/special/_index.adoc | 2 +- .../pt-br/books/porters-handbook/_index.adoc | 30 ++---- .../content/pt-br/books/porters-handbook/book.adoc | 70 ++++++++++++++ .../books/porters-handbook/chapters-order.adoc | 36 ++++---- .../flavors/{chapter.adoc => _index.adoc} | 4 +- .../keeping-up/{chapter.adoc => _index.adoc} | 0 .../makefiles/{chapter.adoc => _index.adoc} | 24 ++--- .../new-port/{chapter.adoc => _index.adoc} | 2 +- .../order/{chapter.adoc => _index.adoc} | 102 ++++++++++----------- .../pkg-files/{chapter.adoc => _index.adoc} | 0 .../plist/{chapter.adoc => _index.adoc} | 16 ++-- .../porting-dads/{chapter.adoc => _index.adoc} | 4 +- .../porting-samplem/{chapter.adoc => _index.adoc} | 4 +- .../porting-why/{chapter.adoc => _index.adoc} | 0 .../quick-porting/{chapter.adoc => _index.adoc} | 14 ++- .../security/{chapter.adoc => _index.adoc} | 0 .../slow-porting/{chapter.adoc => _index.adoc} | 9 +- .../special/{chapter.adoc => _index.adoc} | 56 +++++------ .../testing/{chapter.adoc => _index.adoc} | 4 +- .../upgrading/{chapter.adoc => _index.adoc} | 6 +- .../uses/{chapter.adoc => _index.adoc} | 45 +++++---- .../versions/{chapter.adoc => _index.adoc} | 0 22 files changed, 238 insertions(+), 190 deletions(-) diff --git a/documentation/content/en/books/porters-handbook/special/_index.adoc b/documentation/content/en/books/porters-handbook/special/_index.adoc index 45c69e7d3b..3766f55be2 100644 --- a/documentation/content/en/books/porters-handbook/special/_index.adoc +++ b/documentation/content/en/books/porters-handbook/special/_index.adoc @@ -3117,7 +3117,7 @@ Additionally, these constants are defined so all Java ports may be installed in |The directory where JAR files installed by other ports are located. Default: [.filename]#${LOCALBASE}/share/java/classes#. |=== -The related entries are defined in both `PLIST_SUB` (documented in <>) and `SUB_LIST`. +The related entries are defined in both `PLIST_SUB` (documented in crossref:plist[plist-sub,Changing pkg-plist Based on Make Variables]) and `SUB_LIST`. [[java-building-with-ant]] === Building with Ant diff --git a/documentation/content/pt-br/books/porters-handbook/_index.adoc b/documentation/content/pt-br/books/porters-handbook/_index.adoc index b1f46c3a79..ab02883d70 100644 --- a/documentation/content/pt-br/books/porters-handbook/_index.adoc +++ b/documentation/content/pt-br/books/porters-handbook/_index.adoc @@ -4,21 +4,22 @@ authors: - author: Projeto de Documentação do FreeBSD copyright: 2000-2020 The FreeBSD Documentation Project trademarks: ["freebsd", "sun", "unix", "general"] +next: books/porters-handbook/porting-why +add_single_page_link: true isIndex: true --- = FreeBSD Porter's Handbook :doctype: book :toc: macro -:toclevels: 2 +:toclevels: 1 :icons: font :sectnums: :sectnumlevels: 6 :partnums: :source-highlighter: rouge :experimental: -:book: true -:pdf: false +:images-path: books/porters-handbook/ ifdef::env-beastie[] ifdef::backend-html5[] @@ -44,27 +45,8 @@ endif::[] ''' -toc::[] +include::{chapters-path}toc.adoc[] include::{chapters-path}toc-tables.adoc[] -include::{chapters-path}toc-examples.adoc[] - -include::{chapters-path}porting-why/chapter.adoc[leveloffset=+1] -include::{chapters-path}new-port/chapter.adoc[leveloffset=+1] -include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1] -include::{chapters-path}slow-porting/chapter.adoc[leveloffset=+1] -include::{chapters-path}makefiles/chapter.adoc[leveloffset=+1] -include::{chapters-path}special/chapter.adoc[leveloffset=+1] -include::{chapters-path}flavors/chapter.adoc[leveloffset=+1] -include::{chapters-path}plist/chapter.adoc[leveloffset=+1] -include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1] -include::{chapters-path}testing/chapter.adoc[leveloffset=+1] -include::{chapters-path}upgrading/chapter.adoc[leveloffset=+1] -include::{chapters-path}security/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1] -include::{chapters-path}order/chapter.adoc[leveloffset=+1] -include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1] -include::{chapters-path}uses/chapter.adoc[leveloffset=+1] -include::{chapters-path}versions/chapter.adoc[leveloffset=+1] +include::{chapters-path}toc-examples.adoc[] diff --git a/documentation/content/pt-br/books/porters-handbook/book.adoc b/documentation/content/pt-br/books/porters-handbook/book.adoc new file mode 100644 index 0000000000..b728ab6e06 --- /dev/null +++ b/documentation/content/pt-br/books/porters-handbook/book.adoc @@ -0,0 +1,70 @@ +--- +title: FreeBSD Porter's Handbook +authors: + - author: Projeto de Documentação do FreeBSD +copyright: 2000-2020 The FreeBSD Documentation Project +trademarks: ["freebsd", "sun", "unix", "general"] +isIndex: true +--- + += FreeBSD Porter's Handbook +:doctype: book +:toc: macro +:toclevels: 2 +:icons: font +:sectnums: +:sectnumlevels: 6 +:partnums: +:source-highlighter: rouge +:experimental: +:book: true +:pdf: false + +ifdef::env-beastie[] +ifdef::backend-html5[] +include::shared/authors.adoc[] +include::shared/mirrors.adoc[] +include::shared/releases.adoc[] +include::shared/attributes/attributes-{{% lang %}}.adoc[] +include::shared/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/urls.adoc[] +:chapters-path: content/{{% lang %}}/books/porters-handbook/ +endif::[] +ifdef::backend-pdf,backend-epub3[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] +endif::[] + +ifndef::env-beastie[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] + +''' + +toc::[] + +include::{chapters-path}toc-tables.adoc[] + +include::{chapters-path}toc-examples.adoc[] + +include::{chapters-path}porting-why/_index.adoc[leveloffset=+1] +include::{chapters-path}new-port/_index.adoc[leveloffset=+1] +include::{chapters-path}quick-porting/_index.adoc[leveloffset=+1] +include::{chapters-path}slow-porting/_index.adoc[leveloffset=+1] +include::{chapters-path}makefiles/_index.adoc[leveloffset=+1] +include::{chapters-path}special/_index.adoc[leveloffset=+1] +include::{chapters-path}flavors/_index.adoc[leveloffset=+1] +include::{chapters-path}plist/_index.adoc[leveloffset=+1] +include::{chapters-path}pkg-files/_index.adoc[leveloffset=+1] +include::{chapters-path}testing/_index.adoc[leveloffset=+1] +include::{chapters-path}upgrading/_index.adoc[leveloffset=+1] +include::{chapters-path}security/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-dads/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-samplem/_index.adoc[leveloffset=+1] +include::{chapters-path}order/_index.adoc[leveloffset=+1] +include::{chapters-path}keeping-up/_index.adoc[leveloffset=+1] +include::{chapters-path}uses/_index.adoc[leveloffset=+1] +include::{chapters-path}versions/_index.adoc[leveloffset=+1] diff --git a/documentation/content/pt-br/books/porters-handbook/chapters-order.adoc b/documentation/content/pt-br/books/porters-handbook/chapters-order.adoc index 3aaba51a43..81f5b000cb 100644 --- a/documentation/content/pt-br/books/porters-handbook/chapters-order.adoc +++ b/documentation/content/pt-br/books/porters-handbook/chapters-order.adoc @@ -1,18 +1,18 @@ -porting-why/chapter.adoc -new-port/chapter.adoc -quick-porting/chapter.adoc -slow-porting/chapter.adoc -makefiles/chapter.adoc -special/chapter.adoc -flavors/chapter.adoc -plist/chapter.adoc -pkg-files/chapter.adoc -testing/chapter.adoc -upgrading/chapter.adoc -security/chapter.adoc -porting-dads/chapter.adoc -porting-samplem/chapter.adoc -order/chapter.adoc -keeping-up/chapter.adoc -uses/chapter.adoc -versions/chapter.adoc +porting-why/_index.adoc +new-port/_index.adoc +quick-porting/_index.adoc +slow-porting/_index.adoc +makefiles/_index.adoc +special/_index.adoc +flavors/_index.adoc +plist/_index.adoc +pkg-files/_index.adoc +testing/_index.adoc +upgrading/_index.adoc +security/_index.adoc +porting-dads/_index.adoc +porting-samplem/_index.adoc +order/_index.adoc +keeping-up/_index.adoc +uses/_index.adoc +versions/_index.adoc diff --git a/documentation/content/pt-br/books/porters-handbook/flavors/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/flavors/_index.adoc similarity index 95% rename from documentation/content/pt-br/books/porters-handbook/flavors/chapter.adoc rename to documentation/content/pt-br/books/porters-handbook/flavors/_index.adoc index 412309f480..523bd8a36c 100644 --- a/documentation/content/pt-br/books/porters-handbook/flavors/chapter.adoc +++ b/documentation/content/pt-br/books/porters-handbook/flavors/_index.adoc @@ -353,8 +353,8 @@ USES= python:3.5+ [[flavors-auto-lua]] == `USES=lua` e Flavors -Ao usar <> ou <>, o port terá automaticamente `FLAVORS` preenchidos com as versões Lua que suporta. No entanto, não se espera que aplicativos comuns (em vez de módulos Lua) usem este recurso; a maioria das aplicações que incorporam ou usam Lua simplesmente devem usar `USES=lua`. +Ao usar crossref:uses[uses-lua,`lua:module`] ou crossref:uses[uses-lua,`lua:flavors`], o port terá automaticamente `FLAVORS` preenchidos com as versões Lua que suporta. No entanto, não se espera que aplicativos comuns (em vez de módulos Lua) usem este recurso; a maioria das aplicações que incorporam ou usam Lua simplesmente devem usar `USES=lua`. `LUA_FLAVOR` está disponível (e deve ser usado) para depender da versão correta das dependências, independentemente do port usar os parâmetros `flavors` ou `module`. -Veja <> para maiores informações. +Veja crossref:special[using-lua,Usando Lua] para maiores informações. diff --git a/documentation/content/pt-br/books/porters-handbook/keeping-up/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/keeping-up/_index.adoc similarity index 100% rename from documentation/content/pt-br/books/porters-handbook/keeping-up/chapter.adoc rename to documentation/content/pt-br/books/porters-handbook/keeping-up/_index.adoc diff --git a/documentation/content/pt-br/books/porters-handbook/makefiles/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/makefiles/_index.adoc similarity index 98% rename from documentation/content/pt-br/books/porters-handbook/makefiles/chapter.adoc rename to documentation/content/pt-br/books/porters-handbook/makefiles/_index.adoc index 97d6a7a8d0..f3d616d4c2 100644 --- a/documentation/content/pt-br/books/porters-handbook/makefiles/chapter.adoc +++ b/documentation/content/pt-br/books/porters-handbook/makefiles/_index.adoc @@ -1893,7 +1893,7 @@ DISTNAME= foo EXTRACT_SUFX= .tar.gzip .... -O `USES=tar[:xxx]`, `USES=lha` ou `USES=zip` define automaticamente `EXTRACT_SUFX` com as extensões de arquivo mais comuns, conforme necessário, consulte <> para mais detalhes. Se nenhum destes estiver definido, o `EXTRACT_SUFX` padrão é `.tar.gz`. +O `USES=tar[:xxx]`, `USES=lha` ou `USES=zip` define automaticamente `EXTRACT_SUFX` com as extensões de arquivo mais comuns, conforme necessário, consulte crossref:uses[uses, Usando Macros `USES`] para mais detalhes. Se nenhum destes estiver definido, o `EXTRACT_SUFX` padrão é `.tar.gz`. [NOTE] ==== @@ -2230,7 +2230,7 @@ PATCHFILES= patch1:test ** `fetch-list`: funciona como o antigo `fetch-list`, com a exceção de que faz agrupamentos exatamente como o `do-fetch`. ** `master-sites` e `patch-sites`: (incompatível com versões mais antigas) somente retorna os elementos do grupo `DEFAULT`; na verdade, eles executam os targets `master-sites-default` e `patch-sites-default` respectivamente. + -Além disso, usar o target `master-sites-all` ou `patch-sites-all` é o preferido para verificar diretamente `MASTER_SITES` ou `PATCH_SITES`. Além disso, não é garantido que a checagem direta funcione em versões futuras. Veja <> para obter mais informações sobre esses novos tagets de port. +Além disso, usar o target `master-sites-all` ou `patch-sites-all` é o preferido para verificar diretamente `MASTER_SITES` ou `PATCH_SITES`. Além disso, não é garantido que a checagem direta funcione em versões futuras. Veja <> para obter mais informações sobre esses novos tagets de port. . Novos Targets de Port .. Existem targets `master-sites-_n_` e `patch-sites-_n_` que listarão os elementos do respectivo grupo _n_ dentro de `MASTER_SITES` e `PATCH_SITES` respectivamente. Por exemplo, ambos `master-sites-DEFAULT` e `patch-sites-DEFAULT` retornarão os elementos do grupo `DEFAULT`, `master-sites-test` e `patch-sites-test` do grupo `test`. @@ -3058,7 +3058,7 @@ LICENSE_COMB= multi [[makefile-portscout]] == `PORTSCOUT` -Portscout é um utilitário de verificação de distfile automatizado para a Coleção de Ports do FreeBSD, descrito em detalhes em <>. +Portscout é um utilitário de verificação de distfile automatizado para a Coleção de Ports do FreeBSD, descrito em detalhes em crossref:keeping-up[distfile-survey,Portscout: o Scanner de Distfile de Ports do FreeBSD]. `PORTSCOUT` define condições especiais dentro das quais o scanner distfile do Portscout é restrito. @@ -3211,7 +3211,7 @@ A dependência é verificada a partir do target `extract`. A parte _target_ pode [NOTE] ==== -Use esta variável somente se a extração ainda não funcionar (o padrão usa `tar`) e não funciona com `USES=tar`, `USES=lha` ou `USES=zip` descrito em <>. +Use esta variável somente se a extração ainda não funcionar (o padrão usa `tar`) e não funciona com `USES=tar`, `USES=lha` ou `USES=zip` descrito em crossref:uses[uses,Usando Macros `USES`]. ==== [[makefile-patch_depends]] @@ -3238,7 +3238,7 @@ Parâmetros podem ser adicionados para definir diferentes recursos e dependênci USES= feature[:arguments] .... -Para a lista completa de valores, por favor veja o <>. +Para a lista completa de valores, por favor veja o crossref:uses[uses,Usando Macros `USES`]. [WARNING] ==== @@ -3282,7 +3282,7 @@ O port requer GCC (gcc ou {gcc-plus-plus}) para compilar. Alguns ports precisam |=== -Variáveis ​​relacionadas ao gmake e [.filename]#configure# são descritos em <>, enquanto autoconf, automake e libtool são descritos em <>. Variáveis relacionadas ao Perl ​são descritas em <>. Variáveis ​​X11 são listadas em <>. <> lida com o GNOME e <> com variáveis ​​relacionadas ao KDE. <> documenta variáveis ​​Java, enquanto <> contém informações sobre Apache, PHP e módulos PEAR. Python é discutido em <>, e Ruby em <>. <> fornece variáveis ​​usadas para aplicações SDL e, finalmente, <> contém informações sobre o Xfce. +Variáveis ​​relacionadas ao gmake e [.filename]#configure# são descritos em crossref:special[building, Mecanismos de Compilação], enquanto autoconf, automake e libtool são descritos em crossref:special[using-autotools, Usando o GNU Autotools]. Variáveis relacionadas ao Perl ​são descritas em crossref:special[using-perl, Usando Perl]. Variáveis ​​X11 são listadas em crossref:special[using-x11, Usando o X11]. crossref:special[using-gnome, Usando o GNOME] lida com o GNOME e crossref:special[using-kde, Usando o KDE] com variáveis ​​relacionadas ao KDE. crossref:special[using-java, Usando Java] documenta variáveis ​​Java, enquanto crossref:special[using-php, Aplicações Web, Apache e PHP] contém informações sobre Apache, PHP e módulos PEAR. Python é discutido em crossref:special[using-python, Usando Python], e Ruby em crossref:special[using-ruby, Usando Ruby]. crossref:special[using-sdl, Usando SDL] fornece variáveis ​​usadas para aplicações SD L e, finalmente, crossref:special[using-xfce, Usando o Xfce] contém informações sobre o Xfce. [[makefile-version-dependency]] === Versão Mínima de uma Dependência @@ -4535,7 +4535,7 @@ Existem três variáveis ​​diferentes para registrar um conflito entre pacot [NOTE] ==== -As variáveis ​​de conflito definem automaticamente a variável `IGNORE`, que é mais amplamente documentada em <>. +As variáveis ​​de conflito definem automaticamente a variável `IGNORE`, que é mais amplamente documentada em crossref:porting-dads[dads-noinstall,Marcando um Port não Instalável com a variável `BROKEN` `FORBIDDEN` ou `IGNORE`]. ==== Ao remover um dos vários ports conflitados, é aconselhável reter `CONFLICTS` nos outros ports por alguns meses para atender usuários que apenas fazem atualizações de vez em quando. @@ -4615,7 +4615,7 @@ O estágio `install` é muito importante para o usuário final porque ele adicio [[install-macros]] === Macros `INSTALL_*` -Use as macros fornecidas em [.filename]#bsd.port.mk# para garantir a propriedade correta dos arquivos nos targets `*-install` do port. Defina a propriedade diretamente em [.filename]#pkg-plist# com as entradas correspondentes, como `@(_owner_,_group_,)`, `@owner _owner_`, e `@group _group_`. Esses operadores funcionam até serem substituídos, ou até o final do [.filename]#pkg-plist#, lembre-se de redefini-los depois que eles não forem mais necessários. O valor de propriedade padrão é `root:wheel`. Veja <> para maiores informações. +Use as macros fornecidas em [.filename]#bsd.port.mk# para garantir a propriedade correta dos arquivos nos targets `*-install` do port. Defina a propriedade diretamente em [.filename]#pkg-plist# com as entradas correspondentes, como `@(_owner_,_group_,)`, `@owner _owner_`, e `@group _group_`. Esses operadores funcionam até serem substituídos, ou até o final do [.filename]#pkg-plist#, lembre-se de redefini-los depois que eles não forem mais necessários. O valor de propriedade padrão é `root:wheel`. Veja crossref:plist[plist-keywords-base,Keywords Básicas] para maiores informações. * `INSTALL_PROGRAM` é um comando para instalar executáveis ​​binários. * `INSTALL_SCRIPT` é um comando para instalar scripts executáveis. @@ -4660,7 +4660,7 @@ Use man:file[1] em um arquivo para determinar se ele foi otimizado (stripped). B ==== Quando `WITH_DEBUG` estiver definido, os arquivos elf _não devem_ ser otimizados (stripped). -As variáveis ​​(`STRIP_CMD`, `INSTALL_PROGRAM`, `INSTALL_LIB`, ...) e <> fornecidas pelo framework lidam com isso automaticamente. +As variáveis ​​(`STRIP_CMD`, `INSTALL_PROGRAM`, `INSTALL_LIB`, ...) e crossref:uses[uses,`USES`] fornecidas pelo framework lidam com isso automaticamente. Alguns softwares, adicionam `-s` em seus `LDFLAGS`, neste caso, ou remova o `-s` se `WITH_DEBUG` estiver definido, ou remova o incondicionalmente e use `STRIP_CMD` em `post-install`. ==== @@ -4668,7 +4668,7 @@ Alguns softwares, adicionam `-s` em seus `LDFLAGS`, neste caso, ou remova o `-s` [[install-copytree]] === Instalando uma Árvore Inteira de Arquivos -Às vezes, um grande número de arquivos devem ser instalados preservando sua organização hierárquica. Por exemplo, copiando de uma árvore de diretórios inteira do `WRKSRC` para um diretório de destino sob `PREFIX`. Observe que `PREFIX`, `EXEMPLESDIR`, `DATADIR` e outras variáveis ​​de caminho sempre devem ser precedidas por `STAGEDIR` para respeitar o staging (ver <>). +Às vezes, um grande número de arquivos devem ser instalados preservando sua organização hierárquica. Por exemplo, copiando de uma árvore de diretórios inteira do `WRKSRC` para um diretório de destino sob `PREFIX`. Observe que `PREFIX`, `EXEMPLESDIR`, `DATADIR` e outras variáveis ​​de caminho sempre devem ser precedidas por `STAGEDIR` para respeitar o staging (ver crossref:special[staging,Staging]). Existem duas macros para essa situação. A vantagem de usar essas macros em vez de `cp` é que elas garantem a propriedade e permissão adequada dos arquivos nos arquivos de destino. A primeira macro, `COPYTREE_BIN`, irá definir todos os arquivos instalados como sendo executáveis, sendo assim, adequado para instalações em [.filename]#PREFIX/bin#. A segunda macro,`COPYTREE_SHARE`, não define permissões de execução nos arquivos e, portanto, é adequado para instalar arquivos sob o destino [.filename]#PREFIX/share#. @@ -4709,7 +4709,7 @@ Se o software tiver alguma documentação diferente do manual padrão e páginas Crie um novo diretório para o port. O nome do diretório é `DOCSDIR`. Isso geralmente é igual a `PORTNAME`. No entanto, se o usuário desejar que versões diferentes do port sejam instaladas ao mesmo tempo, `PKGNAME` pode ser usado. -Já que apenas os arquivos listados no [.filename]#pkg-plist# são instalados, é seguro sempre instalar documentações no `STAGEDIR` (veja <>). Por isso, blocos `.if` são necessários apenas quando os arquivos forem grandes o suficiente para causarem sobrecarga significativa de I/O. +Já que apenas os arquivos listados no [.filename]#pkg-plist# são instalados, é seguro sempre instalar documentações no `STAGEDIR` (veja crossref:special[staging,Staging]). Por isso, blocos `.if` são necessários apenas quando os arquivos forem grandes o suficiente para causarem sobrecarga significativa de I/O. [.programlisting] .... @@ -4800,7 +4800,7 @@ USES= python:3.4+,build BINARY_ALIAS= python3=${PYTHON_CMD} .... -Veja <> para mais informações sobre `USES=python`. +Veja crossref:special[using-python,Usando Python] para mais informações sobre `USES=python`. ==== [NOTE] diff --git a/documentation/content/pt-br/books/porters-handbook/new-port/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/new-port/_index.adoc similarity index 96% rename from documentation/content/pt-br/books/porters-handbook/new-port/chapter.adoc rename to documentation/content/pt-br/books/porters-handbook/new-port/_index.adoc index eeb1c1c212..15bf8ef6dd 100644 --- a/documentation/content/pt-br/books/porters-handbook/new-port/chapter.adoc +++ b/documentation/content/pt-br/books/porters-handbook/new-port/_index.adoc @@ -44,7 +44,7 @@ endif::[] Interessado em fazer um novo port ou atualizar os ports existentes? Ótimo! -O que segue são algumas instruções para criar um novo port para o FreeBSD. Para atualizar um port existente, leia este documento e depois leia o <>. +O que segue são algumas instruções para criar um novo port para o FreeBSD. Para atualizar um port existente, leia este documento e depois leia o crossref:upgrading[port-upgrading, Atualizando um Port]. Quando este documento não for suficientemente detalhado, consulte [.filename]#/usr/ports/Mk/bsd.port.mk#, que é incluído por todos os [.filename]##Makefile##s dos ports. Mesmo aqueles que não estão hackeando os [.filename]##Makefile##s diariamente podem ganhar muito conhecimento com isso. Além disso, perguntas específicas podem ser enviadas à http://lists.FreeBSD.org/mailman/listinfo/freebsd-ports[ Lista de discussão do ports do FreeBSD]. diff --git a/documentation/content/pt-br/books/porters-handbook/order/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/order/_index.adoc similarity index 63% rename from documentation/content/pt-br/books/porters-handbook/order/chapter.adoc rename to documentation/content/pt-br/books/porters-handbook/order/_index.adoc index 78da146b3f..a75eb42b8d 100644 --- a/documentation/content/pt-br/books/porters-handbook/order/chapter.adoc +++ b/documentation/content/pt-br/books/porters-handbook/order/_index.adoc @@ -75,54 +75,54 @@ Nos blocos a seguir, apenas defina as variáveis ​​que são requeridas pelo Este bloco é o mais importante. Ele define o nome do port, a versão, o local do arquivo de distribuição e a categoria. As variáveis ​​devem estar nesta ordem: -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> (descontinuado) -* <> -* <> -* <> -* <> -* <> -* <> -* <> +* crossref:makefiles[makefile-portname,`PORTNAME`] +* crossref:makefiles[makefile-versions,`PORTVERSION`][<>] +* crossref:makefiles[makefile-versions,`DISTVERSIONPREFIX`] +* crossref:makefiles[makefile-versions,`DISTVERSION`][<>] +* crossref:makefiles[makefile-versions,`DISTVERSIONSUFFIX`] +* crossref:makefiles[makefile-portrevision,`PORTREVISION`] +* crossref:makefiles[makefile-portepoch,`PORTEPOCH`] +* crossref:makefiles[makefile-categories,`CATEGORIES`] +* crossref:makefiles[makefile-master_sites,`MASTER_SITES`] +* crossref:makefiles[makefile-master_sites-shorthand,`MASTER_SITE_SUBDIR`] (descontinuado) +* crossref:makefiles[porting-pkgnameprefix-suffix,`PKGNAMEPREFIX`] +* crossref:makefiles[porting-pkgnameprefix-suffix,`PKGNAMESUFFIX`] +* crossref:makefiles[makefile-distname,`DISTNAME`] +* crossref:makefiles[makefile-extract_sufx,`EXTRACT_SUFX`] +* crossref:makefiles[makefile-distfiles-definition,`DISTFILES`] +* crossref:makefiles[makefile-dist_subdir,`DIST_SUBDIR`] +* crossref:makefiles[makefile-extract_only,`EXTRACT_ONLY`] [[porting-order-patch]] == Bloco `PATCHFILES` Este bloco é opcional. As variáveis ​​são: -* <> -* <> -* <> +* crossref:makefiles[porting-patchfiles,`PATCH_SITES`] +* crossref:makefiles[porting-patchfiles,`PATCHFILES`] +* crossref:makefiles[porting-patchfiles,`PATCH_DIST_STRIP`] [[porting-order-maintainer]] == Bloco `MAINTAINER` Este bloco é obrigatório. As variáveis ​​são: -* <> -* <> +* crossref:makefiles[makefile-maintainer,`MAINTAINER`] +* crossref:makefiles[makefile-comment,`COMMENT`] [[porting-order-license]] == Bloco `LICENSE` Este bloco é opcional, embora seja altamente recomendado. As variáveis ​​são: -* <> -* <> -* <> ou `LICENSE_GROUPS_NOME` -* <> ou `LICENSE_NAME_NOME` -* <> ou `LICENSE_TEXT_NOME` -* <> ou `LICENSE_FILE_NOME` -* <> ou `LICENSE_PERMS_NOME` -* <> ou `LICENSE_DISTFILES_NOME` +* crossref:makefiles[licenses-license,`LICENSE`] +* crossref:makefiles[licenses-license_comb,`LICENSE_COMB`] +* crossref:makefiles[licenses-license_groups,`LICENSE_GROUPS`] ou `LICENSE_GROUPS_NAME` +* crossref:makefiles[licenses-license_name,`LICENSE_NAME`] ou `LICENSE_NAME_NAME` +* crossref:makefiles[licenses-license_text,`LICENSE_TEXT`] ou `LICENSE_TEXT_NAME` +* crossref:makefiles[licenses-license_file,`LICENSE_FILE`] ou `LICENSE_FILE_NAME` +* crossref:makefiles[licenses-license_perms,`LICENSE_PERMS`] ou `LICENSE_PERMS_NAME_` +* crossref:makefiles[licenses-license_distfiles,`LICENSE_DISTFILES`] ou `LICENSE_DISTFILES_NAME` Se houver várias licenças, ordene as variáveis LICENSE_VAR_NOME pelo nome de licença. @@ -131,21 +131,21 @@ Se houver várias licenças, ordene as variáveis LICENSE_VAR_NOME pelo nome de Este bloco é opcional. As variáveis ​​são: -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> +* crossref:porting-dads[dads-deprecated,`DEPRECATED`] +* crossref:porting-dads[dads-deprecated,`EXPIRATION_DATE`] +* crossref:porting-dads[dads-noinstall,`FORBIDDEN`] +* crossref:porting-dads[dads-noinstall,`BROKEN`] +* crossref:porting-dads[dads-noinstall,`BROKEN_*`] +* crossref:porting-dads[dads-noinstall,`IGNORE`] +* crossref:porting-dads[dads-noinstall,`IGNORE_*`] +* crossref:porting-dads[dads-noinstall,`ONLY_FOR_ARCHS`] +* crossref:porting-dads[dads-noinstall,`ONLY_FOR_ARCHS_REASON*`] +* crossref:porting-dads[dads-noinstall,`NOT_FOR_ARCHS`] +* crossref:porting-dads[dads-noinstall,`NOT_FOR_ARCHS_REASON*`] [NOTE] ==== -`BROKEN_*` e `IGNORE_*` podem ser qualquer variável genérica, por exemplo, `IGNORE_amd64`, `BROKEN_FreeBSD_10`, etc. Com exceção das variáveis ​​que dependem de uma variável <>, coloque essas em <>. Por exemplo, `IGNORE_WITH_PHP` só funciona se <> estiver definido e a variável `BROKEN_SSL` somente se <> estiver definido. +`BROKEN_*` e `IGNORE_*` podem ser qualquer variável genérica, por exemplo, `IGNORE_amd64`, `BROKEN_FreeBSD_10`, etc. Com exceção das variáveis ​​que dependem de uma variável crossref:uses[uses,`USES`], coloque essas em <>. Por exemplo, `IGNORE_WITH_PHP` só funciona se crossref:uses[xuses-php,`php`] estiver definido e a variável `BROKEN_SSL` somente se crossref:uses[uses-ssl,`ssl`] estiver definido. Se o port estiver marcado como BROKEN quando algumas condições forem atendidas, e tais condições puderem ser testadas somente após incluir o [.filename]#bsd.port.options.mk# ou [.filename]#bsd.port.pre.mk#, então essas variáveis ​​devem ser definidas mais tarde, em <>. ==== @@ -155,12 +155,12 @@ Se o port estiver marcado como BROKEN quando algumas condições forem atendidas Este bloco é opcional. As variáveis ​​são: -* <> -* <> -* <> -* <> -* <> -* <> +* crossref:makefiles:[makefile-fetch_depends,`FETCH_DEPENDS`] +* crossref:makefiles:[makefile-extract_depends,`EXTRACT_DEPENDS`] +* crossref:makefiles:[makefile-patch_depends,`PATCH_DEPENDS`] +* crossref:makefiles:[makefile-build_depends,`BUILD_DEPENDS`] +* crossref:makefiles:[makefile-lib_depends,`LIB_DEPENDS`] +* crossref:makefiles:[makefile-run_depends,`RUN_DEPENDS`] * `TEST_DEPENDS` [[porting-order-flavors]] @@ -168,7 +168,7 @@ Este bloco é opcional. As variáveis ​​são: Este bloco é opcional. -Comece esta seção com as definições de `FLAVORS`. Continue com as possíveis variáveis assistentes de Flavors. Veja <> para maiores informações. +Comece esta seção com as definições de `FLAVORS`. Continue com as possíveis variáveis assistentes de Flavors. Veja crossref:flavors[flavors-using,Usando FLAVORS] para maiores informações. Variáveis ​​de definição de construção não disponíveis como assistentes, usando `.if ${FLAVOR:U} == foo` devem ir em abaixo de suas respectivas seções. @@ -177,7 +177,7 @@ Variáveis ​​de definição de construção não disponíveis como assistent Comece esta seção com a definição da variável `USES` e, em seguida, possíveis variáveis `USE_x`. -Mantenha as variáveis ​​relacionadas juntas. Por exemplo, se estiver usando a variável <>, coloque sempre as variáveis `GH_*` ​​logo após ela. +Mantenha as variáveis ​​relacionadas juntas. Por exemplo, se estiver usando a variável crossref:makefiles[makefile-master_sites-github,`USE_GITHUB`], coloque sempre as variáveis `GH_*` ​​logo após ela. [[porting-order-variables]] == Variáveis ​​Padrão [.filename]#bsd.port.mk# @@ -189,7 +189,7 @@ A ordem não é importante, no entanto, tente manter variáveis ​​semelhante [[porting-order-options]] == Opções e Assistentes -Se o port usa o <>, defina `OPTIONS_DEFINE` e `OPTIONS_DEFAULT`, então as outras variáveis `OPTIONS__*_`, depois as de descrições `_*__DESC`, e então os assistentes de opções. Tente e ordene todas essas variáveis alfabeticamente. +Se o port usa o crossref:makefiles[makefile-options,framework de opções], defina `OPTIONS_DEFINE` e `OPTIONS_DEFAULT`, então as outras variáveis `OPTIONS__*_`, depois as de descrições `_*__DESC`, e então os assistentes de opções. Tente e ordene todas essas variáveis alfabeticamente. [[porting-order-options-ex1]] .Exemplo de Ordenamento das Variáveis ​​de Opções diff --git a/documentation/content/pt-br/books/porters-handbook/pkg-files/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/pkg-files/_index.adoc similarity index 100% rename from documentation/content/pt-br/books/porters-handbook/pkg-files/chapter.adoc rename to documentation/content/pt-br/books/porters-handbook/pkg-files/_index.adoc diff --git a/documentation/content/pt-br/books/porters-handbook/plist/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/plist/_index.adoc similarity index 97% rename from documentation/content/pt-br/books/porters-handbook/plist/chapter.adoc rename to documentation/content/pt-br/books/porters-handbook/plist/_index.adoc index 7dc7c5c089..275ee64b41 100644 --- a/documentation/content/pt-br/books/porters-handbook/plist/chapter.adoc +++ b/documentation/content/pt-br/books/porters-handbook/plist/_index.adoc @@ -1,11 +1,11 @@ --- -title: Capítulo 8. Prácticas Avançadas de [.filename]#pkg-plist# +title: Capítulo 8. Prácticas Avançadas de pkg-plist prev: books/porters-handbook/flavors next: books/porters-handbook/pkg-files --- [[plist]] -= Prácticas Avançadas de [.filename]#pkg-plist# += Prácticas Avançadas de pkg-plist :doctype: book :toc: macro :toclevels: 1 @@ -45,7 +45,7 @@ endif::[] [[plist-sub]] == Alterando o [.filename]#pkg-plist# Baseado em Variáveis Make -Alguns ports, particularmente os `p5-` ports, precisam mudar seus [.filename]#pkg-plist# dependendo de quais opções eles são configurados com (ou versão de `perl`, no caso de `p5-` ports). Para tornar isso fácil, todas as instâncias [.filename]#pkg-plist# de `%%OSREL%%`, `%%PERL_VER%%` e `%%PERL_VERSION%%` serão substituídas apropriadamente. O valor de `%%OSREL%%` é a revisão numérica do sistema operacional (por exemplo,`4.9`). `%%PERL_VERSION%%` e `%%PERL_VER%%` é o número completo da versão `perl` (por exemplo,`5.8.9`). Muitos outros `%%_VARS_%%` relacionados aos arquivos de documentação do port são descritos na <>. +Alguns ports, particularmente os `p5-` ports, precisam mudar seus [.filename]#pkg-plist# dependendo de quais opções eles são configurados com (ou versão de `perl`, no caso de `p5-` ports). Para tornar isso fácil, todas as instâncias [.filename]#pkg-plist# de `%%OSREL%%`, `%%PERL_VER%%` e `%%PERL_VERSION%%` serão substituídas apropriadamente. O valor de `%%OSREL%%` é a revisão numérica do sistema operacional (por exemplo,`4.9`). `%%PERL_VERSION%%` e `%%PERL_VER%%` é o número completo da versão `perl` (por exemplo,`5.8.9`). Muitos outros `%%_VARS_%%` relacionados aos arquivos de documentação do port são descritos na crossref:makefiles[install-documentation,seção relevante]. Para fazer outras substituições, defina `PLIST_SUB` com uma lista de pares `_VAR_=_VALOR_` e as instâncias de `%%_VAR_%%` serão substituídas por _VALOR_ no [.filename]#pkg-plist#. @@ -59,7 +59,7 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION} no [.filename]#Makefile# e use `%%OCTAVE_VERSION%%` onde quer que a versão apareça em [.filename]#pkg-plist#. Quando o port é atualizado, não será necessário editar dezenas (ou em alguns casos, centenas) de linhas no [.filename]#pkg-plist#. -Se os arquivos são instalados condicionalmente pelas opções definidas no port, a maneira usual de lidar com isso é prefixando as linhas [.filename]#pkg-plist# com `%%OPT%%` para linhas necessárias quando a opção está ativada ou `%%NO_OPT%%` quando a opção está desativada e adicionando `OPTIONS_SUB=yes` ao [.filename]#Makefile#. Veja <> para mais informações. +Se os arquivos são instalados condicionalmente pelas opções definidas no port, a maneira usual de lidar com isso é prefixando as linhas [.filename]#pkg-plist# com `%%OPT%%` para linhas necessárias quando a opção está ativada ou `%%NO_OPT%%` quando a opção está desativada e adicionando `OPTIONS_SUB=yes` ao [.filename]#Makefile#. Veja crossref:makefiles[options_sub,`OPTIONS_SUB`] para mais informações. Por exemplo, se houver arquivos que são instalados apenas quando a opção `X11` está ativada, e o [.filename]#Makefile# tem: @@ -273,20 +273,20 @@ Os argumentos são opcionais. Se apenas o grupo e o modo precisarem ser alterado [WARNING] ==== -Se uma keyword for utilizada em uma entrada de <>, ela precisa ser adicionada após o assistente: +Se uma keyword for utilizada em uma entrada de crossref:makefiles[makefile-options,opção], ela precisa ser adicionada após o assistente: [.programlisting] .... %%FOO%%@sample etc/orbit.conf.sample .... -Isso é porque os assistentes plist das opções são utilizados para comentar as linhas, e por isso eles precisam ser inseridos no início. Veja <> para maiores informações. +Isso é porque os assistentes plist das opções são utilizados para comentar as linhas, e por isso eles precisam ser inseridos no início. Veja crossref:makefiles[options_sub,`OPTIONS_SUB`] para maiores informações. ==== [[plist-keywords-desktop-file-utils]] === `@desktop-file-utils` -Irá executar o `update-desktop-database -q` após a instalação e desinstalação. _Nunca_ use diretamente, adicione <> ao [.filename]#Makefile#. +Irá executar o `update-desktop-database -q` após a instalação e desinstalação. _Nunca_ use diretamente, adicione crossref:uses[uses-desktop-file-utils,`USES=desktop-file-utils`] ao [.filename]#Makefile#. [[plist-keywords-fc]] === `@fc` _directory_ @@ -311,7 +311,7 @@ Executa `glib-compile-schemas` na instalação e desinstalação. [[plist-keywords-info]] === `@info` _file_ -Adiciona o arquivo passado como argumento ao plist e atualiza o índice do documento info na instalação e desinstalação. Além disso, ele remove o índice se estiver vazio na desinstalação. Isso nunca deve ser usado manualmente, mas sempre `INFO`. Veja <> para maiores informações. +Adiciona o arquivo passado como argumento ao plist e atualiza o índice do documento info na instalação e desinstalação. Além disso, ele remove o índice se estiver vazio na desinstalação. Isso nunca deve ser usado manualmente, mas sempre `INFO`. Veja crossref:makefiles[makefile-info,Arquivos de Informação] para maiores informações. [[plist-keywords-kld]] === `@kld` _directory_ diff --git a/documentation/content/pt-br/books/porters-handbook/porting-dads/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/porting-dads/_index.adoc similarity index 98% rename from documentation/content/pt-br/books/porters-handbook/porting-dads/chapter.adoc rename to documentation/content/pt-br/books/porters-handbook/porting-dads/_index.adoc index 36d877d007..5864e41365 100644 --- a/documentation/content/pt-br/books/porters-handbook/porting-dads/chapter.adoc +++ b/documentation/content/pt-br/books/porters-handbook/porting-dads/_index.adoc @@ -84,7 +84,7 @@ para o lugar adequado no arquivo [.filename]#.c#. #endif .... -Uma lista completa de valores `__FreeBSD_version` está disponível em <>. +Uma lista completa de valores `__FreeBSD_version` está disponível em crossref:versions[versions, Valores `__FreeBSD_version`]. [[dads-after-port-mk]] == Escrevendo Algo Depois do [.filename]#bsd.port.mk# @@ -403,7 +403,7 @@ Não existe uma política definida sobre o tempo de aviso a ser dado. A prática A maneira correta de um [.filename]#Makefile# sinalizar que o port não pode ser instalado devido a algum fator externo (por exemplo, o usuário especificou uma combinação ilegal de opções de compilação) é definir um valor não vazio para `IGNORE`. Este valor será formatado e mostrado ao usuário pelo comando `make install`. -É um equívoco comum usar `.error` para esse propósito. O problema com isso é que muitas ferramentas automatizadas que funcionam com a árvore de ports falharão nessa situação. A ocorrência mais comum disso é encontrada ao tentar construir o arquivo [.filename]#/usr/ports/INDEX# (Veja <>). No entanto, comandos ainda mais triviais, como `make maintainer` também irão falhar neste cenário. E Isto não é aceitável. +É um equívoco comum usar `.error` para esse propósito. O problema com isso é que muitas ferramentas automatizadas que funcionam com a árvore de ports falharão nessa situação. A ocorrência mais comum disso é encontrada ao tentar construir o arquivo [.filename]#/usr/ports/INDEX# (Veja crossref:testing[make-describe, Executando `make describe`]). No entanto, comandos ainda mais triviais, como `make maintainer` também irão falhar neste cenário. E Isto não é aceitável. [[dot-error-breaks-index]] .Como Evitar o Uso de `.error` diff --git a/documentation/content/pt-br/books/porters-handbook/porting-samplem/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/porting-samplem/_index.adoc similarity index 97% rename from documentation/content/pt-br/books/porters-handbook/porting-samplem/chapter.adoc rename to documentation/content/pt-br/books/porters-handbook/porting-samplem/_index.adoc index dbcd834f8d..3a6e02ebdf 100644 --- a/documentation/content/pt-br/books/porters-handbook/porting-samplem/chapter.adoc +++ b/documentation/content/pt-br/books/porters-handbook/porting-samplem/_index.adoc @@ -1,11 +1,11 @@ --- -title: Capítulo 14. Um Exemplo de [.filename]#Makefile# +title: Capítulo 14. Um Exemplo de Makefile prev: books/porters-handbook/porting-dads next: books/porters-handbook/order --- [[porting-samplem]] -= Um Exemplo de [.filename]#Makefile# += Um Exemplo de Makefile :doctype: book :toc: macro :toclevels: 1 diff --git a/documentation/content/pt-br/books/porters-handbook/porting-why/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/porting-why/_index.adoc similarity index 100% rename from documentation/content/pt-br/books/porters-handbook/porting-why/chapter.adoc rename to documentation/content/pt-br/books/porters-handbook/porting-why/_index.adoc diff --git a/documentation/content/pt-br/books/porters-handbook/quick-porting/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/quick-porting/_index.adoc similarity index 94% rename from documentation/content/pt-br/books/porters-handbook/quick-porting/chapter.adoc rename to documentation/content/pt-br/books/porters-handbook/quick-porting/_index.adoc index 905a356219..31223a5e39 100644 --- a/documentation/content/pt-br/books/porters-handbook/quick-porting/chapter.adoc +++ b/documentation/content/pt-br/books/porters-handbook/quick-porting/_index.adoc @@ -42,13 +42,13 @@ toc::[] include::../../../../../shared/asciidoctor.adoc[] endif::[] -Esta seção descreve como criar rapidamente um novo port. Para aplicativos em que esse método rápido não for adequado, o processo "Slow Porting" está descrito no <>. +Esta seção descreve como criar rapidamente um novo port. Para aplicativos em que esse método rápido não for adequado, o processo "Slow Porting" está descrito no crossref:slow-porting[slow-porting,Port Lento]. Primeiro, obtenha o tarball original e coloque-o em `DISTDIR`, que por padrão é o diretório [.filename]#/usr/ports/distfiles#. [NOTE] ==== -Estas etapas assumem que o software foi compilado de forma simples (out-of-the-box). Em outras palavras, não foi necessária absolutamente nenhuma mudança para o aplicativo funcionar em um sistema FreeBSD. Se alguma coisa teve que ser alterada, por favor consulte o <>. +Estas etapas assumem que o software foi compilado de forma simples (out-of-the-box). Em outras palavras, não foi necessária absolutamente nenhuma mudança para o aplicativo funcionar em um sistema FreeBSD. Se alguma coisa teve que ser alterada, por favor consulte o crossref:slow-porting[slow-porting,Port Lento]. ==== [NOTE] @@ -177,14 +177,12 @@ Uso de `PLIST_FILES` não deve ser abusado. Ao procurar pela origem de um arquiv [TIP] ==== - -Se um port precisar criar um diretório vazio, ou criar diretórios fora do [.filename]#${PREFIX}# durante a instalação, consulte <> para maiores informações. +Se um port precisar criar um diretório vazio, ou criar diretórios fora do [.filename]#${PREFIX}# durante a instalação, consulte crossref:plist[plist-dir-cleaning,Limpando Diretórios Vazios] para maiores informações. ==== [TIP] ==== - -Como `PLIST_FILES` é uma variavel do man:make[1], qualquer entrada com espaços deve ser envolvida por aspas. Por exemplo, se estiver usando palavras-chave descritas em man:pkg-create[8] e na <>, a entrada deve ser citada. +Como `PLIST_FILES` é uma variavel do man:make[1], qualquer entrada com espaços deve ser envolvida por aspas. Por exemplo, se estiver usando palavras-chave descritas em man:pkg-create[8] e na crossref:plist[plist-keywords,Expandindo a Lista de Pacotes com Keywords], a entrada deve ser citada. [.programlisting] .... @@ -210,7 +208,7 @@ Certifique-se de que as regras do port façam exatamente o que é desejado, incl * O port pode ser instalado usando o target `install`. Isso verifica se o script de instalação está funcionando corretamente. * O port pode ser desinstalado adequadamente usando o target `deinstall`. Isso verifica se o script de desinstalação funciona corretamente. * O port só tem acesso aos recursos de rede durante a fase target `fetch`. Isto é importante para os construtores de pacotes, tais como o package:ports-mgmt/poudriere[]. -* Certifique-se de que o comando `make package` pode ser executado como um usuário normal (ou seja, não como `root`). Se isso falhar, talvez seja necessário corrigir o software. Veja a <> e também a <>. +* Certifique-se de que o comando `make package` pode ser executado como um usuário normal (ou seja, não como `root`). Se isso falhar, talvez seja necessário corrigir o software. Veja a crossref:uses[uses-fakeroot,`fakeroot`] e também a crossref:uses[uses-uidfix,`uidfix`]. [.procedure] ==== @@ -226,7 +224,7 @@ Certifique-se de que as regras do port façam exatamente o que é desejado, incl Certifique-se de que nenhum aviso é exibido em nenhum dos estágios. -Testes automatizados completos podem ser feitos com o package:ports-mgmt/poudriere[] da coleção do Ports, veja a <> para maiores informações. Ele mantém `jails` onde todas as etapas mostradas acima podem ser testadas sem afetar o estado do sistema host. +Testes automatizados completos podem ser feitos com o package:ports-mgmt/poudriere[] da coleção do Ports, veja a crossref:testing[testing-poudriere,Poudriere] para maiores informações. Ele mantém `jails` onde todas as etapas mostradas acima podem ser testadas sem afetar o estado do sistema host. [[porting-portlint]] == Verificando o Port com `portlint` diff --git a/documentation/content/pt-br/books/porters-handbook/security/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/security/_index.adoc similarity index 100% rename from documentation/content/pt-br/books/porters-handbook/security/chapter.adoc rename to documentation/content/pt-br/books/porters-handbook/security/_index.adoc diff --git a/documentation/content/pt-br/books/porters-handbook/slow-porting/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/slow-porting/_index.adoc similarity index 96% rename from documentation/content/pt-br/books/porters-handbook/slow-porting/chapter.adoc rename to documentation/content/pt-br/books/porters-handbook/slow-porting/_index.adoc index b1d466a219..c58c9bcd1e 100644 --- a/documentation/content/pt-br/books/porters-handbook/slow-porting/chapter.adoc +++ b/documentation/content/pt-br/books/porters-handbook/slow-porting/_index.adoc @@ -60,7 +60,7 @@ Mas não se preocupe, não são muitas as pessoas que entendem exatamente como o .. Se existir, [.filename]#scripts/configure# é executado. .. E se `HAS_CONFIGURE` ou `GNU_CONFIGURE` está definido, [.filename]#WRKSRC/configure# é executado. . O target `build` é executado. Ele é responsável por mudar para o diretório de trabalho privado do port (`WRKSRC`) e compila-lo. -. O target `stage` é executado. Este coloca o conjunto final de arquivos construídos em um diretório temporário (`STAGEDIR`, Veja <>). A hierarquia deste diretório espelha a do sistema no qual o pacote será instalado. +. O target `stage` é executado. Este coloca o conjunto final de arquivos construídos em um diretório temporário (`STAGEDIR`, Veja crossref:special[staging,Staging]). A hierarquia deste diretório espelha a do sistema no qual o pacote será instalado. . O target `package` é executado. Ele cria um pacote usando os arquivos do diretório temporário criado durante o target `stage` e o [.filename]#pkg-plist# do port. . O target `install` é executado. Este instala o pacote criado durante o target `package` no host. ==== @@ -83,7 +83,7 @@ Agora que o que acontece quando o usuário digita `make install` é melhor enten Obtenha os fontes originais (normalmente) como um tarball compactado ([.filename]#foo.tar.gz# ou [.filename]#foo.tar.bz2#) e copie-o para `DISTDIR`. Use fontes do _mainstream_ sempre que possível. -Definir a variável `MASTER_SITES` para refletir onde o tarball original reside. Existem definições abreviadas para a maioria dos sites mainstream em [.filename]#bsd.sites.mk#. Por favor, use esses sites - e as definições associadas--se for possível, para ajudar a evitar o problema de ter as mesmas informações repetidas várias vezes na base de origem. Como esses sites tendem a mudar com o tempo, isso se torna um pesadelo de manutenção para todos os envolvidos. Veja <> para detalhes. +Definir a variável `MASTER_SITES` para refletir onde o tarball original reside. Existem definições abreviadas para a maioria dos sites mainstream em [.filename]#bsd.sites.mk#. Por favor, use esses sites - e as definições associadas--se for possível, para ajudar a evitar o problema de ter as mesmas informações repetidas várias vezes na base de origem. Como esses sites tendem a mudar com o tempo, isso se torna um pesadelo de manutenção para todos os envolvidos. Veja crossref:makefiles[makefile-master_sites,`MASTER_SITES`] para detalhes. Se não houver nenhum site FTP/HTTP bem conectado à rede ou se puder encontrar apenas sites com formatos irritantemente não-padrão, coloque uma cópia em um servidor FTP ou HTTP confiável (por exemplo, uma home page). @@ -119,8 +119,7 @@ Depois que todas as alterações forem realizadas, `cd` de volta ao diretório d [TIP] ==== - -Usar `BINARY_ALIAS` para substituir comandos codificados durante a compilação e para evitar patching de arquivos de compilação. Veja <> para maiores informações. +Usar `BINARY_ALIAS` para substituir comandos codificados durante a compilação e para evitar patching de arquivos de compilação. Veja crossref:makefiles[binary-alias,Use `BINARY_ALIAS` para Renomear Comandos Em Vez de Aplicar Patch na Compilação] para maiores informações. ==== [[slow-patch-rules]] @@ -247,7 +246,7 @@ EXTRA_PATCHES= ${PATCHDIR}/extra-patch-fbsd10 .Aplicando Opcionalmente um Patch [example] ==== -Quando um <> requer um patch, use `OPT_EXTRA_PATCHES` e `OPT_EXTRA_PATCHES_OFF` para fazer o patch condicional na opção `_opt_`. Veja <> Para maiores informações. +Quando um crossref:makefiles[makefile-options,option] requer um patch, use `OPT_EXTRA_PATCHES` e `OPT_EXTRA_PATCHES_OFF` para fazer o patch condicional na opção `_opt_`. Veja <> Para maiores informações. [.programlisting] .... diff --git a/documentation/content/pt-br/books/porters-handbook/special/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/special/_index.adoc similarity index 97% rename from documentation/content/pt-br/books/porters-handbook/special/chapter.adoc rename to documentation/content/pt-br/books/porters-handbook/special/_index.adoc index 8750eba096..a79e3f7b5c 100644 --- a/documentation/content/pt-br/books/porters-handbook/special/chapter.adoc +++ b/documentation/content/pt-br/books/porters-handbook/special/_index.adoc @@ -47,11 +47,11 @@ Esta seção explica as coisas mais comuns a se considerar ao criar um port. [[staging]] == Staging -[.filename]#bsd.port.mk# espera que os ports trabalhem com um "stage directory". Isso significa que um port não deve instalar arquivos diretamente nos diretórios de destino regulares (isto é, sob o `PREFIX`, por exemplo), mas em um diretório separado a partir do qual o pacote será construído. Em muitos casos, isso não requer privilégios de root, tornando possível criar pacotes como um usuário não privilegiado. Com o staging, o port é compilado e instalado no diretório sde estágio, `STAGEDIR`. Um pacote é criado a partir do diretório de estágio e, em seguida, instalado no sistema. As ferramentas Automake referem-se a este conceito como `DESTDIR`, mas no FreeBSD, `DESTDIR` tem um significado diferente (veja <>). +[.filename]#bsd.port.mk# espera que os ports trabalhem com um "stage directory". Isso significa que um port não deve instalar arquivos diretamente nos diretórios de destino regulares (isto é, sob o `PREFIX`, por exemplo), mas em um diretório separado a partir do qual o pacote será construído. Em muitos casos, isso não requer privilégios de root, tornando possível criar pacotes como um usuário não privilegiado. Com o staging, o port é compilado e instalado no diretório sde estágio, `STAGEDIR`. Um pacote é criado a partir do diretório de estágio e, em seguida, instalado no sistema. As ferramentas Automake referem-se a este conceito como `DESTDIR`, mas no FreeBSD, `DESTDIR` tem um significado diferente (veja crossref:testing[porting-prefix,`PREFIX` e `DESTDIR`]). [NOTE] ==== -Nenhum port _realmente_ precisa de root. Ele pode ser evitado principalmente usando <>. Se o port ainda executa comandos como man:chown[8], man:chgrp[1] ou força o proprietário ou grupo com man:install[1] então use <> para enganar essas chamadas. Algumas modificações no [.filename]#Makefile# do port serão necessárias. +Nenhum port _realmente_ precisa de root. Ele pode ser evitado principalmente usando crossref:uses[uses-uidfix,`USES=uidfix`]. Se o port ainda executa comandos como man:chown[8], man:chgrp[1] ou força o proprietário ou grupo com man:install[1] então use crossref:uses[uses-fakeroot,`USES=fakeroot`] para enganar essas chamadas. Algumas modificações no [.filename]#Makefile# do port serão necessárias. ==== Os meta ports, ou ports que não instalam arquivos por si mesmos e apenas dependem de outros ports, devem evitar extrair desnecessariamente man:mtree[8] para o diretório de estágio. Este é o layout básico do diretório do pacote, e estes diretórios vazios serão vistos como órfãos. Para prevenir extração do man:mtree[8], adicione esta linha: @@ -281,7 +281,7 @@ Se o port usa o GNU make, adicione o `gmake` no `USES`. A variável `MAKE_CMD` pode ser usada para referenciar o comando específico configurado pelo `USES` no [.filename]#Makefile# do port. Use o `MAKE_CMD` apenas dentro dos [.filename]##Makefile##s do aplicativo no `WRKSRC` para chamar o comando `make` para a implementação esperada pelo software portado. -Se o port é um aplicativo X que usa o Imake para criar o [.filename]#Makefile# do [.filename]#Imakefile#, defina `USES=imake`. Veja a seção sobre <> no <> para mais detalhes. +Se o port é um aplicativo X que usa o Imake para criar o [.filename]#Makefile# do [.filename]#Imakefile#, defina `USES=imake`. Veja a seção sobre crossref:uses[uses-imake,`USES=imake`] no crossref:uses[uses,Usando Macros `USES`] para mais detalhes. Se o [.filename]#Makefile# do port tem algo diferente de `all` como o target de compilação principal, defina a variável `ALL_TARGET` adequadamente. O mesmo vale para `install` e `INSTALL_TARGET`. @@ -393,7 +393,7 @@ CMAKE_ARGS= -DVAR1:BOOL=TRUE -DVAR2:BOOL=TRUE -DVAR3:BOOL=FALSE [IMPORTANT] ====== -Isto é apenas para os valores padrão desativados do `CMAKE_ARGS`. Os helpers descritos em <> usam a mesma semântica, mas para valores opcionais. +Isto é apenas para os valores padrão desativados do `CMAKE_ARGS`. Os helpers descritos em crossref:makefiles[options-cmake_bool,`OPT_CMAKE_BOOL` e `OPT_CMAKE_BOOL_OFF`] usam a mesma semântica, mas para valores opcionais. ====== ==== @@ -662,7 +662,7 @@ PULSEAUDIO_VARS= CARGO_FEATURES+=pulseaudio_backend .Listando Licenças Crate [example] ==== -Os crates têm suas próprias licenças. É importante saber o que elas são ao adicionar o bloco `LICENSE` para o port (ver<>). O target auxiliar `cargo-crates-licenses` tentará listar todas as licenças de todos os crates definidos no `CARGO_CRATES`. +Os crates têm suas próprias licenças. É importante saber o que elas são ao adicionar o bloco `LICENSE` para o port (ver crossref:makefiles[licenses,Licenças]). O target auxiliar `cargo-crates-licenses` tentará listar todas as licenças de todos os crates definidos no `CARGO_CRATES`. [source,shell] .... @@ -678,7 +678,7 @@ byteorder-1.2.2 Unlicense/MIT [NOTE] ====== -Os nomes das licenças geradas com `make cargo-create-licenses` são expressões de licenças do SPDX 2.1 que não correspondem aos nomes de licença definidos na estrutura de ports. Eles precisam ser traduzidos para os nomes de <>. +Os nomes das licenças geradas com `make cargo-create-licenses` são expressões de licenças do SPDX 2.1 que não correspondem aos nomes de licença definidos na estrutura de ports. Eles precisam ser traduzidos para os nomes de crossref:makefiles[licenses-license-list, Lista de Licenças Predefinidas]. ====== ==== @@ -719,7 +719,7 @@ MESON_ARGS= -Dfoo=enabled [[using-go]] === Compilando Aplicações Go -Para ports que usam Go, defina `USES=go`. Consulte <> para obter a lista de variáveis que podem ser configuradas para controlar o processo de compilação. +Para ports que usam Go, defina `USES=go`. Consulte crossref:uses[uses-go,`go`] para obter a lista de variáveis que podem ser configuradas para controlar o processo de compilação. [[go-ex1]] .Criando um Port para uma Aplicação Baseada em Módulos Go @@ -845,7 +845,7 @@ irá instalar `dnscrypt-proxy` em `${PREFIX}/sbin`. [[using-cabal]] === Compilando Aplicações Haskell com `cabal` -Para ports que usam Cabal, defina o sistema de compilação `USES=cabal`. Consulte <> para obter a lista de variáveis que podem ser configuradas para controlar o processo de compilação. +Para ports que usam Cabal, defina o sistema de compilação `USES=cabal`. Consulte crossref:uses[uses-cabal,`cabal`] para obter a lista de variáveis que podem ser configuradas para controlar o processo de compilação. [[cabal-ex1]] .Criando um Port para uma Aplicação Hackage-hosted Haskell @@ -943,7 +943,7 @@ Se você não estiver testando seu port em um ambiente limpo, como com o Poudrie [[using-autotools]] == Usando o GNU Autotools -Se um port precisar de algum software GNU Autotools, adicione `USES=autoreconf`. Veja <> Para maiores informações. +Se um port precisar de algum software GNU Autotools, adicione `USES=autoreconf`. Veja crossref:uses[uses-autoreconf,`autoreconf`] Para maiores informações. [[using-gettext]] == Usando o GNU `gettext` @@ -951,7 +951,7 @@ Se um port precisar de algum software GNU Autotools, adicione `USES=autoreconf`. [[using-gettext-basic]] === Uso Básico -Se o port requer o `gettext`, defina `USES=gettext`, e o port herdará a dependência [.filename]#libintl.so# do package:devel/gettext[]. Outros valores para uso do `gettext` estão listados em <>. +Se o port requer o `gettext`, defina `USES=gettext`, e o port herdará a dependência [.filename]#libintl.so# do package:devel/gettext[]. Outros valores para uso do `gettext` estão listados em crossref:uses[uses-gettext,`USES=gettext`]. Um caso bastante comum é um port que utilize o `gettext` e o `configure`. Geralmente, o GNU `configure` deve ser capaz de localizar o `gettext` automaticamente. @@ -1170,9 +1170,9 @@ USE_PERL5= modbuildtiny [[x11-variables]] === Componentes X.Org -A implementação do X11 disponível na Coleção de Ports é o X.Org. Se o aplicativo depender de componentes X, adicione `USES= xorg` e defina `USE_XORG` na lista de componentes necessários. Uma lista completa pode ser encontrada em <>. +A implementação do X11 disponível na Coleção de Ports é o X.Org. Se o aplicativo depender de componentes X, adicione `USES= xorg` e defina `USE_XORG` na lista de componentes necessários. Uma lista completa pode ser encontrada em crossref:uses[uses-xorg,`xorg`]. -O Projeto Mesa é um esforço para fornecer implementação gratuita do OpenGL. Para especificar uma dependência em vários componentes deste projeto, use a variável `USE_GL`. Veja <> para a lista completa dos componentes disponíveis. Para compatibilidade com versões anteriores, o valor `yes` direciona para `glu`. +O Projeto Mesa é um esforço para fornecer implementação gratuita do OpenGL. Para especificar uma dependência em vários componentes deste projeto, use a variável `USE_GL`. Veja crossref:uses[uses-gl,`gl`] para a lista completa dos componentes disponíveis. Para compatibilidade com versões anteriores, o valor `yes` direciona para `glu`. [[use-xorg-example]] .Exemplo `USE_XORG` @@ -1749,7 +1749,7 @@ Para mais ajuda com um port GNOME, veja alguns dos https://www.FreeBSD.org/ports [NOTE] ==== -Para ports que fazem parte do Qt, veja <>. +Para ports que fazem parte do Qt, veja crossref:uses[uses-qt-dist,`qt-dist`]. ==== [[qt-common]] @@ -2895,7 +2895,7 @@ Além disso, essas constantes são definidas para que todos os ports Java possam |O diretório onde os arquivos JAR instalados por outros ports estão localizados. Padrão: [.filename]#${LOCALBASE}/shared/java/classes#. |=== -As entradas relacionadas são definidas em ambos `PLIST_SUB` (documentado em <>) e `SUB_LIST`. +As entradas relacionadas são definidas em ambos `PLIST_SUB` (documentado em crossref:plist[plist-sub,Alterando o pkg-plist Baseado em Variáveis Make]) e `SUB_LIST`. [[java-building-with-ant]] === Compilando com Ant @@ -2933,7 +2933,7 @@ do-install: Independentemente do tipo de port (biblioteca ou aplicativo), a documentação adicional é instalada na <> como para qualquer outro port. A ferramenta Javadoc é conhecida por produzir um conjunto diferente de arquivos, dependendo da versão do JDK utilizado. Para ports que não impõem o uso de um determinado JDK, é uma tarefa complexa especificar a lista de empacotamento ([.filename]#pkg-plist#). Esta é uma razão pela qual os mantenedores de ports são fortemente encorajados a usar `PORTDOCS`. Além disso, mesmo se o conjunto de arquivos que serão gerados pelo `javadoc` puder ser previsto, o tamanho do [.filename]#pkg-plist# resultante irá encorajar o uso do `PORTDOCS`. -O valor padrão para `DATADIR` é [.filename]#${PREFIX}/shared/${PORTNAME}#. É uma boa ideia sobreescrever `DATADIR` para [.filename]#${JAVASHAREDIR}/${PORTNAME}# para ports Java. De fato, `DATADIR` é automaticamente adicionado a `PLIST_SUB` (documentado em<>) então use `%%DATADIR%%` diretamente em [.filename]#pkg-plist#. +O valor padrão para `DATADIR` é [.filename]#${PREFIX}/shared/${PORTNAME}#. É uma boa ideia sobreescrever `DATADIR` para [.filename]#${JAVASHAREDIR}/${PORTNAME}# para ports Java. De fato, `DATADIR` é automaticamente adicionado a `PLIST_SUB` (documentado em crossref:plist[plist-sub, Alterando o pkg-plist Baseado em Variáveis Make]) então use `%%DATADIR%%` diretamente em [.filename]#pkg-plist#. Quanto à escolha de compilar ports Java a partir do código fonte ou instalar diretamente a partir de uma distribuição binária, não há política definida no momento da escrita deste livro. No entanto, os membros do https://www.freebsd.org/java/[Projeto Java do FreeBSD] encorajam os mantenedores de ports a terem seus ports compilados a partir do código fonte sempre que for possível. @@ -2941,7 +2941,7 @@ Todos os recursos que foram apresentados nesta seção são implementados em [.f Embora haja uma categoria `Java` para PRs, isso refere-se ao esforço de portabilidade do JDK do projeto Java do FreeBSD. Portanto, envie o port Java na categoria `ports` como para qualquer outro port, a menos que o problema esteja relacionado a uma implementação do JDK ou ao [.filename]#bsd.java.mk#. -Da mesma forma, existe uma política definida sobre as `CATEGORIAS` de um port Java, que é detalhada em <>. +Da mesma forma, existe uma política definida sobre as `CATEGORIAS` de um port Java, que é detalhada em crossref:makefiles[makefile-categories,Categorização]. [[using-php]] == Aplicações Web, Apache e PHP @@ -3018,7 +3018,7 @@ Não insira o Apache como dependência, a menos que o aplicativo web precise exp [[php-variables]] === PHP -Aplicações PHP declaram sua dependência a ele com `USES=php`. Veja <> para maiores informações. +Aplicações PHP declaram sua dependência a ele com `USES=php`. Veja crossref:uses[uses-php,`php`] para maiores informações. [[php-pear]] === Módulos PEAR @@ -3137,7 +3137,7 @@ PKGNAMEPREFIX= ${PYTHON_PKGNAMEPREFIX} |O port usará um prefixo exclusivo, normalmente `PYTHON_PKGNAMEPREFIX` para determinados diretórios, como `EXAMPLESDIR` e `DOCSDIR` e também irá acrescentar um sufixo, a versão python de `PYTHON_VER`, para os binários e scripts que serão instalados. Isso permite que os ports sejam instalados para diferentes versões do Python ao mesmo tempo, o que de outra forma instalaria arquivos conflitantes. |`USE_PYTHON=flavors` -|O port não usa distutils, mas ainda suporta várias versões do Python. .`FLAVORS` será definido para as versões suportadas do Python. Veja <> para maiores informações. +|O port não usa distutils, mas ainda suporta várias versões do Python. .`FLAVORS` será definido para as versões suportadas do Python. Veja crossref:flavors[flavors-auto-python,`USES`=python e Flavors] para maiores informações. |`USE_PYTHON=optsuffix` |Se a versão atual do Python não for a versão padrão, o port receberá `PKGNAMESUFFIX=${PYTHON_PKGNAMESUFFIX}`. É útil apenas com flavors. @@ -3259,7 +3259,7 @@ A Coleção de Ports suporta a instalação paralela de múltiplas versões do T |caminho dos arquivos de cabeçalho C do Tk |=== -Veja o <> e <> do <> para uma descrição completa dessas variáveis. Uma lista completa dessas variáveis ​​está disponível em [.filename]#/usr/ports/Mk/Uses/tcl.mk#. +Veja o <> e <> do crossref:uses[uses,Usando Macros `USES`] para uma descrição completa dessas variáveis. Uma lista completa dessas variáveis ​​está disponível em [.filename]#/usr/ports/Mk/Uses/tcl.mk#. [[using-ruby]] == Usando Ruby @@ -4063,16 +4063,16 @@ Utilize uma das macros `USES` de <> para adicionar a depen | Macro USES |Berkeley DB -|<> +|crossref:uses[uses-bdb,`bdb`] |MariaDB, MySQL, Percona -|<> +|crossref:uses[uses-mysql,`mysql`] |PostgreSQL -|<> +|crossref:uses[uses-pgsql,`pgsql`] |SQLite -|<> +|crossref:uses[uses-sqlite,`sqlite`] |=== [[using-databases-bdb-ex1]] @@ -4084,7 +4084,7 @@ Utilize uma das macros `USES` de <> para adicionar a depen USES= bdb:6 .... -Veja <> para maiores informações. +Veja crossref:uses[uses-bdb,`bdb`] para maiores informações. ==== [[using-databases-mysql-ex1]] @@ -4098,7 +4098,7 @@ Quando um port precisa da biblioteca cliente do MySQL, adicione USES= mysql .... -Veja <> para mais informações. +Veja crossref:uses[uses-mysql,`mysql`] para mais informações. *** 297 LINES SKIPPED *** From nobody Sat Nov 27 12:38:24 2021 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 A424918B87B2 for ; Sat, 27 Nov 2021 12:38:25 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4J1WPF1N8Qz4rrr; Sat, 27 Nov 2021 12:38:25 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 0884C1C187; Sat, 27 Nov 2021 12:38:25 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1ARCcOdp076293; Sat, 27 Nov 2021 12:38:24 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1ARCcOW7076292; Sat, 27 Nov 2021 12:38:24 GMT (envelope-from git) Date: Sat, 27 Nov 2021 12:38:24 GMT Message-Id: <202111271238.1ARCcOW7076292@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 9368c9279b - main - Split Russian porter's handbook 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 9368c9279be9891602c4630228a8a4ced8f1c302 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1638016705; 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; bh=Z54ix+1OisURQ3N4gz/E5USu4YuOIZtBjt3eqTaAY9U=; b=IpPW3jPWtWtvBeZJY9413KPJnAPWpQyMiPVJoYXRKZbY7438pHLH/uPRvNdhlXgXjc0cEP ysivPkTiCfy1spuuZQMx3Fsg7YJE3FrOy0iaRh/ToGsATdpAp2VJhtRqDS6PK6AIcEHLWg 8lyVHLzpKomFVjM8AcPE5MBBkez9ItyDT4ntJ/TZ0BlKmqTPKxxZial3qHxnCHAaYxb76K XOvTbCVReLJxfaYon8qzI70ft4JtwDNAX0DFI3LoNz9cPGX0T1iVCi3jBHBz5J3k9p5aku UuOm0vA9XPE4RzunJ4MnlHKmyLzxnSUJT7CGyZ/HbPIZ5EdeffeocStLvgmjPA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1638016705; a=rsa-sha256; cv=none; b=teMy2bUTr6mSyBzVqnqavqh9ZNqoxBfJ8rVWIam1XmlPvx+tnwEaxZwfQFCD5H9KPgxmB6 XSB/LrgfNprrhEAcyjnrPJiGiC6rF3st3NzN9v3yhzyq/kgzurWl4J9qjcwdXbRPczOuMR p5EcbvSlT3MBQf4JhciKv2a3GrWoXNKC/PPhAgRTRWl3ZaIBmqscMqEd6FJf2D2p/F3s7z qf4kd9Vut/9CkmG+CzVr84LAXY9v8NJNY6dBH99QyCggMCE1KozWmr8QJP5McxYyPvCxyS nIaPCDz+Lr+3ZdSgNP9e7A7mkFm/H4SgKpdZfGXqT05zhr9wsvqmS8bI/SVbZw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=9368c9279be9891602c4630228a8a4ced8f1c302 commit 9368c9279be9891602c4630228a8a4ced8f1c302 Author: Sergio Carlavilla Delgado AuthorDate: 2021-11-27 12:38:04 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-11-27 12:38:04 +0000 Split Russian porter's handbook --- .../content/ru/books/porters-handbook/_index.adoc | 26 +- .../content/ru/books/porters-handbook/book.adoc | 68 +++ .../ru/books/porters-handbook/chapters-order.adoc | 32 +- .../keeping-up/{chapter.adoc => _index.adoc} | 0 .../makefiles/{chapter.adoc => _index.adoc} | 10 +- .../new-port/{chapter.adoc => _index.adoc} | 2 +- .../pkg-files/{chapter.adoc => _index.adoc} | 2 +- .../plist/{chapter.adoc => _index.adoc} | 4 +- .../porting-dads/{chapter.adoc => _index.adoc} | 2 +- .../porting-samplem/{chapter.adoc => _index.adoc} | 0 .../porting-why/{chapter.adoc => _index.adoc} | 0 .../quick-porting/{chapter.adoc => _index.adoc} | 6 +- .../security/{chapter.adoc => _index.adoc} | 0 .../slow-porting/{chapter.adoc => _index.adoc} | 2 +- .../special/{chapter.adoc => _index.adoc} | 10 +- .../testing/{chapter.adoc => _index.adoc} | 6 +- .../upgrading/{chapter.adoc => _index.adoc} | 4 +- .../uses/{chapter.adoc => _index.adoc} | 579 +++++++++++++++------ .../versions/{chapter.adoc => _index.adoc} | 0 19 files changed, 521 insertions(+), 232 deletions(-) diff --git a/documentation/content/ru/books/porters-handbook/_index.adoc b/documentation/content/ru/books/porters-handbook/_index.adoc index 1b6f7d092c..0395f5d5e7 100644 --- a/documentation/content/ru/books/porters-handbook/_index.adoc +++ b/documentation/content/ru/books/porters-handbook/_index.adoc @@ -4,21 +4,22 @@ authors: - author: The FreeBSD Documentation Project copyright: 2000-2020 The FreeBSD Documentation Project trademarks: ["freebsd", "sun", "unix", "general"] +next: books/porters-handbook/porting-why +add_single_page_link: true isIndex: true --- = Руководство FreeBSD по созданию портов :doctype: book :toc: macro -:toclevels: 2 +:toclevels: 1 :icons: font :sectnums: :sectnumlevels: 6 :partnums: :source-highlighter: rouge :experimental: -:book: true -:pdf: false +:images-path: books/porters-handbook/ ifdef::env-beastie[] ifdef::backend-html5[] @@ -44,25 +45,8 @@ endif::[] ''' -toc::[] +include::{chapters-path}toc.adoc[] include::{chapters-path}toc-tables.adoc[] include::{chapters-path}toc-examples.adoc[] - -include::{chapters-path}porting-why/chapter.adoc[leveloffset=+1] -include::{chapters-path}new-port/chapter.adoc[leveloffset=+1] -include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1] -include::{chapters-path}slow-porting/chapter.adoc[leveloffset=+1] -include::{chapters-path}makefiles/chapter.adoc[leveloffset=+1] -include::{chapters-path}special/chapter.adoc[leveloffset=+1] -include::{chapters-path}plist/chapter.adoc[leveloffset=+1] -include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1] -include::{chapters-path}testing/chapter.adoc[leveloffset=+1] -include::{chapters-path}upgrading/chapter.adoc[leveloffset=+1] -include::{chapters-path}security/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1] -include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1] -include::{chapters-path}uses/chapter.adoc[leveloffset=+1] -include::{chapters-path}versions/chapter.adoc[leveloffset=+1] diff --git a/documentation/content/ru/books/porters-handbook/book.adoc b/documentation/content/ru/books/porters-handbook/book.adoc new file mode 100644 index 0000000000..c10afd18bc --- /dev/null +++ b/documentation/content/ru/books/porters-handbook/book.adoc @@ -0,0 +1,68 @@ +--- +title: Руководство FreeBSD по созданию портов +authors: + - author: The FreeBSD Documentation Project +copyright: 2000-2020 The FreeBSD Documentation Project +trademarks: ["freebsd", "sun", "unix", "general"] +add_split_page_link: true +--- + += FreeBSD Porter's Handbook +:doctype: book +:toc: macro +:toclevels: 2 +:icons: font +:sectnums: +:sectnumlevels: 6 +:partnums: +:source-highlighter: rouge +:experimental: +:book: true +:pdf: false + +ifdef::env-beastie[] +ifdef::backend-html5[] +include::shared/authors.adoc[] +include::shared/mirrors.adoc[] +include::shared/releases.adoc[] +include::shared/attributes/attributes-{{% lang %}}.adoc[] +include::shared/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/urls.adoc[] +:chapters-path: content/{{% lang %}}/books/porters-handbook/ +endif::[] +ifdef::backend-pdf,backend-epub3[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] +endif::[] + +ifndef::env-beastie[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] + +''' + +toc::[] + +include::{chapters-path}toc-tables.adoc[] + +include::{chapters-path}toc-examples.adoc[] + +include::{chapters-path}porting-why/_index.adoc[leveloffset=+1] +include::{chapters-path}new-port/_index.adoc[leveloffset=+1] +include::{chapters-path}quick-porting/_index.adoc[leveloffset=+1] +include::{chapters-path}slow-porting/_index.adoc[leveloffset=+1] +include::{chapters-path}makefiles/_index.adoc[leveloffset=+1] +include::{chapters-path}special/_index.adoc[leveloffset=+1] +include::{chapters-path}plist/_index.adoc[leveloffset=+1] +include::{chapters-path}pkg-files/_index.adoc[leveloffset=+1] +include::{chapters-path}testing/_index.adoc[leveloffset=+1] +include::{chapters-path}upgrading/_index.adoc[leveloffset=+1] +include::{chapters-path}security/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-dads/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-samplem/_index.adoc[leveloffset=+1] +include::{chapters-path}keeping-up/_index.adoc[leveloffset=+1] +include::{chapters-path}uses/_index.adoc[leveloffset=+1] +include::{chapters-path}versions/_index.adoc[leveloffset=+1] diff --git a/documentation/content/ru/books/porters-handbook/chapters-order.adoc b/documentation/content/ru/books/porters-handbook/chapters-order.adoc index f7a766c744..80ccba6333 100644 --- a/documentation/content/ru/books/porters-handbook/chapters-order.adoc +++ b/documentation/content/ru/books/porters-handbook/chapters-order.adoc @@ -1,16 +1,16 @@ -porting-why/chapter.adoc -new-port/chapter.adoc -quick-porting/chapter.adoc -slow-porting/chapter.adoc -makefiles/chapter.adoc -special/chapter.adoc -plist/chapter.adoc -pkg-files/chapter.adoc -testing/chapter.adoc -upgrading/chapter.adoc -security/chapter.adoc -porting-dads/chapter.adoc -porting-samplem/chapter.adoc -keeping-up/chapter.adoc -uses/chapter.adoc -versions/chapter.adoc +porting-why/_index.adoc +new-port/_index.adoc +quick-porting/_index.adoc +slow-porting/_index.adoc +makefiles/_index.adoc +special/_index.adoc +plist/_index.adoc +pkg-files/_index.adoc +testing/_index.adoc +upgrading/_index.adoc +security/_index.adoc +porting-dads/_index.adoc +porting-samplem/_index.adoc +keeping-up/_index.adoc +uses/_index.adoc +versions/_index.adoc diff --git a/documentation/content/ru/books/porters-handbook/keeping-up/chapter.adoc b/documentation/content/ru/books/porters-handbook/keeping-up/_index.adoc similarity index 100% rename from documentation/content/ru/books/porters-handbook/keeping-up/chapter.adoc rename to documentation/content/ru/books/porters-handbook/keeping-up/_index.adoc diff --git a/documentation/content/ru/books/porters-handbook/makefiles/chapter.adoc b/documentation/content/ru/books/porters-handbook/makefiles/_index.adoc similarity index 98% rename from documentation/content/ru/books/porters-handbook/makefiles/chapter.adoc rename to documentation/content/ru/books/porters-handbook/makefiles/_index.adoc index 721539ccb6..a8cc2643e9 100644 --- a/documentation/content/ru/books/porters-handbook/makefiles/chapter.adoc +++ b/documentation/content/ru/books/porters-handbook/makefiles/_index.adoc @@ -1176,7 +1176,7 @@ PATCHFILES= patch1:test ** `fetch-list`: работает так же, как старая цель `fetch-list` с тем исключением, что она группирует, как и `do-fetch`. ** `master-sites` и `patch-sites`: (несовместимы со старыми версиями) только возвращают элементы группы `DEFAULT`; на самом деле они выполняют цели `master-sites-default` и `patch-sites-default` соответственно. + -Более того, использование целей `master-sites-all` или `patch-sites-all` предпочтительно для непосредственной проверки `MASTER_SITES` или `PATCH_SITES`. Также работа прямой проверки в последующих версиях не гарантируется. Посмотрите <> для получения более дополнительной информации об этих новых целях. +Более того, использование целей `master-sites-all` или `patch-sites-all` предпочтительно для непосредственной проверки `MASTER_SITES` или `PATCH_SITES`. Также работа прямой проверки в последующих версиях не гарантируется. Посмотрите <> для получения более дополнительной информации об этих новых целях. . Новые цели построения портов .. Имеются цели `master-sites-_n_` и `patch-sites-_n_`, которые будут перечислять элементы соответствующей группы _n_ из `MASTER_SITES` и `PATCH_SITES` соответственно. К примеру, `master-sites-DEFAULT` и `patch-sites-DEFAULT` обе будут возвращать элементы группы `DEFAULT`, `master-sites-test` и `patch-sites-test` группы `test` и так далее. @@ -1254,7 +1254,7 @@ COMMENT= Cat chasing a mouse all over the screen [[makefile-portscout]] == `PORTSCOUT` -Portscout являет собой автоматизированное средство проверки доступности дистрибутивных файлов для Коллекции Портов FreeBSD, подробное описание которого предоставляет <>. +Portscout являет собой автоматизированное средство проверки доступности дистрибутивных файлов для Коллекции Портов FreeBSD, подробное описание которого предоставляет crossref:keeping-up[distfile-survey, Portscout: сканер дистрибутивных файлов портов FreeBSD]. Переменная `PORTSCOUT` задаёт специальные условия, ограничивающие работу Portscout - сканера дистрибутивных файлов. @@ -1456,7 +1456,7 @@ USE_GCC=X.Y |Для сборки порта требуется GCC (gcc или {gcc-plus-plus}). Некоторым портам подходит любая версия, для других требуются последние современные версии. Обычно используется со значением `any` (в этом случае используется встроенный GCC в тех версиях FreeBSD, в состав которых он всё ещё входит, или устанавливается порт `lang/gcc`, когда Clang является компилятором C/C++ по умолчанию) или `yes` (всегда используется стабильная современная версия GCC из порта `lang/gcc`). Также в значении переменной можно указать точную версию, например `4.7`. Минимально допустимую версию можно указать как `4.6+`. GCC из основной системы используется в случае, если его версия удовлетворяет запрошенной, иначе собирается подходящая версии компилятора из порта с соответствующей коррекцией переменных `CC` и `CXX`. |=== -Переменные, относящиеся к gmake и сценарию [.filename]#configure#, описаны в <>, а autoconf, automake и libtool описаны в <>. Переменные, связанные с Perl, описаны в <>. Переменные X11 перечислены в <>. <> работает с переменными GNOME и <> с KDE. <> описывает переменные Java, а <> содержит информацию об Apache, PHP и модулях PEAR. Python обсуждается в <>, а Ruby в <>. <> предоставляет переменные, используемые для приложений SDL, и, наконец, <> содержит информацию о приложении Xfce. +Переменные, относящиеся к gmake и сценарию [.filename]#configure#, описаны в crossref:special[building, Механизмы построения], а autoconf, automake и libtool описаны в crossref:special[using-autotools, Использование GNU Autotools]. Переменные, связанные с Perl, описаны в crossref:special[using-perl, Использование Perl]. Переменные X11 перечислены в crossref:special[using-x11, Использование X11]. crossref:special[using-gnome, Использование GNOME] работает с переменными GNOME и crossref:special[using-kde, Использование KDE] с KDE. crossref:special[using-java, Использование Java] описывает переменные Java, а crossref:special[using-php, Веб-приложения, Apache и PHP] содержит информацию об Apache, PHP и модулях P EAR. Python обсуждается в crossref:special[using-python, Использование Python], а Ruby в crossref:special[using-ruby, Использование Ruby]. crossref:special[using-sdl, Использование SDL] предоставляет переменные, используемые для приложений SDL, и, наконец, crossref:special[using-xfce, Использование Xfce] содержит информацию о приложении Xfce. === Минимальная версия зависимости @@ -2218,7 +2218,7 @@ NO_WRKSUBDIR= yes [NOTE] ==== -Переменные регистрации конфликта автоматически определяют переменную `IGNORE`, которая более подробно описана в <>. +Переменные регистрации конфликта автоматически определяют переменную `IGNORE`, которая более подробно описана в crossref:porting-dads[dads-noinstall, "Пометка неустанавливаемого порта как `BROKEN`, `FORBIDDEN` или `IGNORE` "]. ==== При удалении одного из конфликтующих портов целесообразно сохранить записи `CONFLICTS` в тех других портах в течении нескольких месяцев, чтобы позаботиться о тех пользователей, которые обновляются от случая к случаю. @@ -2321,7 +2321,7 @@ post-install: Создайте для вашего порта новый каталог. Имя каталога должно соответствовать тому, что представляет из себя порт. Обычно это означает `PORTNAME`. Однако, если вы думаете, что пользователь захочет иметь разные версии порта, установленные одновременно, то вы можете использовать полное имя `PKGNAME`. -Поскольку устанавливаются только файлы, перечисленные в [.filename]#pkg-plist#, безопасным способом будет устанавливать документацию в `STAGEDIR` всегда (смотрите <>). Следовательно, блоки `.if` нужны только для файлов достаточно большого размера, установка которых влечёт значительные накладные расходы на операции ввода/вывода. +Поскольку устанавливаются только файлы, перечисленные в [.filename]#pkg-plist#, безопасным способом будет устанавливать документацию в `STAGEDIR` всегда (смотрите crossref:special[staging, Staging]). Следовательно, блоки `.if` нужны только для файлов достаточно большого размера, установка которых влечёт значительные накладные расходы на операции ввода/вывода. [.programlisting] .... diff --git a/documentation/content/ru/books/porters-handbook/new-port/chapter.adoc b/documentation/content/ru/books/porters-handbook/new-port/_index.adoc similarity index 97% rename from documentation/content/ru/books/porters-handbook/new-port/chapter.adoc rename to documentation/content/ru/books/porters-handbook/new-port/_index.adoc index 43b61bce99..e4a0c67481 100644 --- a/documentation/content/ru/books/porters-handbook/new-port/chapter.adoc +++ b/documentation/content/ru/books/porters-handbook/new-port/_index.adoc @@ -44,7 +44,7 @@ endif::[] Итак, вы интересуетесь, как создать собственный порт или обновить существующий? Великолепно! -Ниже находятся некоторые указания по созданию нового порта для FreeBSD. Если вы хотите обновить существующий порт, вы должны прочесть их, а затем <>. +Ниже находятся некоторые указания по созданию нового порта для FreeBSD. Если вы хотите обновить существующий порт, вы должны прочесть их, а затем crossref:upgrading[port-upgrading, Обновление отдельного порта]. Если этот документ недостаточно подробен, вы должны обратиться к файлу [.filename]#/usr/ports/Mk/bsd.port.mk#, который включается в make-файл каждого порта. Он хорошо прокомментирован, и даже если вы не занимаетесь хакингом make-файлов каждодневно, из него вы сможете узнать много нового. Кроме того, конкретные вопросы можно задать, послав письмо на адрес {freebsd-ports}. diff --git a/documentation/content/ru/books/porters-handbook/pkg-files/chapter.adoc b/documentation/content/ru/books/porters-handbook/pkg-files/_index.adoc similarity index 99% rename from documentation/content/ru/books/porters-handbook/pkg-files/chapter.adoc rename to documentation/content/ru/books/porters-handbook/pkg-files/_index.adoc index 5f98929394..7b641bf91b 100644 --- a/documentation/content/ru/books/porters-handbook/pkg-files/chapter.adoc +++ b/documentation/content/ru/books/porters-handbook/pkg-files/_index.adoc @@ -5,7 +5,7 @@ next: books/porters-handbook/testing --- [[pkg-files]] -= Файлы [.filename]#pkg-*# += Файлы pkg-* :doctype: book :toc: macro :toclevels: 1 diff --git a/documentation/content/ru/books/porters-handbook/plist/chapter.adoc b/documentation/content/ru/books/porters-handbook/plist/_index.adoc similarity index 99% rename from documentation/content/ru/books/porters-handbook/plist/chapter.adoc rename to documentation/content/ru/books/porters-handbook/plist/_index.adoc index db57d34ca3..1f84971b10 100644 --- a/documentation/content/ru/books/porters-handbook/plist/chapter.adoc +++ b/documentation/content/ru/books/porters-handbook/plist/_index.adoc @@ -1,11 +1,11 @@ --- -title: Глава 7. Продвинутые практики [.filename]#pkg-plist# +title: Глава 7. Продвинутые практики pkg-plist prev: books/porters-handbook/special next: books/porters-handbook/pkg-files --- [[plist]] -= Продвинутые практики [.filename]#pkg-plist# += Продвинутые практики pkg-plist :doctype: book :toc: macro :toclevels: 1 diff --git a/documentation/content/ru/books/porters-handbook/porting-dads/chapter.adoc b/documentation/content/ru/books/porters-handbook/porting-dads/_index.adoc similarity index 99% rename from documentation/content/ru/books/porters-handbook/porting-dads/chapter.adoc rename to documentation/content/ru/books/porters-handbook/porting-dads/_index.adoc index 1960a211a4..28f6049c6a 100644 --- a/documentation/content/ru/books/porters-handbook/porting-dads/chapter.adoc +++ b/documentation/content/ru/books/porters-handbook/porting-dads/_index.adoc @@ -348,7 +348,7 @@ IGNORE= unsupported on recent versions Правильным способом подать сигнал для [.filename]#Makefile# о том, что порт не может быть установлен из-за какого-то внешнего фактора (например, пользователь указал недопустимую комбинацию опций построения), является установка непустого значения для `IGNORE`. Это значение будет сформатировано и показано пользователю во время `make install`. -Использование для этих целей `.error` является распространенной ошибкой. Проблема в том, что в этой ситуации будут повреждены многие инструменты автоматизации, работающие с деревом портов. Наибольшим образом это распространено при попытке построить [.filename]#/usr/ports/INDEX# (смотрите <>). Тем не менее, даже более простые команды, такие как `make maintainer`, в этом случае также вернут ошибку. Это не является приемлемым. +Использование для этих целей `.error` является распространенной ошибкой. Проблема в том, что в этой ситуации будут повреждены многие инструменты автоматизации, работающие с деревом портов. Наибольшим образом это распространено при попытке построить [.filename]#/usr/ports/INDEX# (смотрите crossref:testing[make-describe, Запуск `make describe`]). Тем не менее, даже более простые команды, такие как `make maintainer`, в этом случае также вернут ошибку. Это не является приемлемым. [[dot-error-breaks-index]] .Как избегать использования `.error` diff --git a/documentation/content/ru/books/porters-handbook/porting-samplem/chapter.adoc b/documentation/content/ru/books/porters-handbook/porting-samplem/_index.adoc similarity index 100% rename from documentation/content/ru/books/porters-handbook/porting-samplem/chapter.adoc rename to documentation/content/ru/books/porters-handbook/porting-samplem/_index.adoc diff --git a/documentation/content/ru/books/porters-handbook/porting-why/chapter.adoc b/documentation/content/ru/books/porters-handbook/porting-why/_index.adoc similarity index 100% rename from documentation/content/ru/books/porters-handbook/porting-why/chapter.adoc rename to documentation/content/ru/books/porters-handbook/porting-why/_index.adoc diff --git a/documentation/content/ru/books/porters-handbook/quick-porting/chapter.adoc b/documentation/content/ru/books/porters-handbook/quick-porting/_index.adoc similarity index 98% rename from documentation/content/ru/books/porters-handbook/quick-porting/chapter.adoc rename to documentation/content/ru/books/porters-handbook/quick-porting/_index.adoc index 87e1275c42..bebfdd67ee 100644 --- a/documentation/content/ru/books/porters-handbook/quick-porting/chapter.adoc +++ b/documentation/content/ru/books/porters-handbook/quick-porting/_index.adoc @@ -171,12 +171,12 @@ PLIST_DIRS= lib/X11/oneko [NOTE] ==== -Несколько портов могут совместно использовать общий каталог. В этом случае `PLIST_DIRS` следует заменить на `PLIST_DIRSTRY`, так чтобы каталог удалялся только если он пуст, а иначе игнорировался. Использование `PLIST_DIRS` и `PLIST_DIRSTRY` аналогично `@dirrm` и `@dirrmtry` в [.filename]#pkg-plist#, описание которых входит в <>. +Несколько портов могут совместно использовать общий каталог. В этом случае `PLIST_DIRS` следует заменить на `PLIST_DIRSTRY`, так чтобы каталог удалялся только если он пуст, а иначе игнорировался. Использование `PLIST_DIRS` и `PLIST_DIRSTRY` аналогично `@dirrm` и `@dirrmtry` в [.filename]#pkg-plist#, описание которых входит в crossref:plist[plist-dir-cleaning,Очистка пустых каталогов]. ==== Обратной стороной такого способа перечисления файлов и каталогов порта является невозможность использования последовательностей команд, описанных в man:pkg-create[8]. Поэтому он подходит для простых портов, что делает их ещё более простыми. Одновременно с этим положительным моментом является уменьшение количества файлов в коллекции портов. Пожалуйста, подумайте над использованием этой техники, прежде чем создавать [.filename]#pkg-plist#. -Далее мы увидим, как можно использовать файлы [.filename]#pkg-plist# и `PLIST_FILES` выполнения <>. +Далее мы увидим, как можно использовать файлы [.filename]#pkg-plist# и `PLIST_FILES` выполнения crossref:plist[plist,более сложных задач]. [[porting-checksum]] == Создание файла с контрольной суммой @@ -221,7 +221,7 @@ PLIST_DIRS= lib/X11/oneko [[porting-submitting]] == Посылка нового порта -Перед посылкой нового порта прочитайте раздел о том, что <> делать. +Перед посылкой нового порта прочитайте раздел о том, что crossref:porting-dads[porting-dads,можно и нельзя] делать. Когда вы наконец довольны своим первым портом, единственное, что осталось сделать, это включить его в основное дерево портов FreeBSD и осчастливить этим всех остальных. Нам не нужен ни каталог [.filename]#work#, ни пакет [.filename]#pkgname.tgz#, так что удалите их прямо сейчас. diff --git a/documentation/content/ru/books/porters-handbook/security/chapter.adoc b/documentation/content/ru/books/porters-handbook/security/_index.adoc similarity index 100% rename from documentation/content/ru/books/porters-handbook/security/chapter.adoc rename to documentation/content/ru/books/porters-handbook/security/_index.adoc diff --git a/documentation/content/ru/books/porters-handbook/slow-porting/chapter.adoc b/documentation/content/ru/books/porters-handbook/slow-porting/_index.adoc similarity index 99% rename from documentation/content/ru/books/porters-handbook/slow-porting/chapter.adoc rename to documentation/content/ru/books/porters-handbook/slow-porting/_index.adoc index 1d7cbc61e7..2cadd40028 100644 --- a/documentation/content/ru/books/porters-handbook/slow-porting/chapter.adoc +++ b/documentation/content/ru/books/porters-handbook/slow-porting/_index.adoc @@ -61,7 +61,7 @@ endif::[] .. Если задана переменная `HAS_CONFIGURE` или `GNU_CONFIGURE`, то запускается скрипт [.filename]#WRKSRC/configure#. . Выполняется цель `build`. Она отвечает за переход в собственный рабочий каталог порта (`WRKSRC`) и его построение. -. Выполняется цель `stage`. Конечный набор построенных файлов помещается во временный каталог (`STAGEDIR`, смотрите <>). Иерархия этого каталога отражает иерархию каталогов системы, в которую данный пакет будет устанавливаться. +. Выполняется цель `stage`. Конечный набор построенных файлов помещается во временный каталог (`STAGEDIR`, смотрите crossref:special[staging,Staging]). Иерархия этого каталога отражает иерархию каталогов системы, в которую данный пакет будет устанавливаться. . Выполняется цель `install`. В систему копируются файлы, перечисленные в pkg-plist порта. ==== diff --git a/documentation/content/ru/books/porters-handbook/special/chapter.adoc b/documentation/content/ru/books/porters-handbook/special/_index.adoc similarity index 99% rename from documentation/content/ru/books/porters-handbook/special/chapter.adoc rename to documentation/content/ru/books/porters-handbook/special/_index.adoc index c46eb9a002..ac01c34875 100644 --- a/documentation/content/ru/books/porters-handbook/special/chapter.adoc +++ b/documentation/content/ru/books/porters-handbook/special/_index.adoc @@ -47,7 +47,7 @@ endif::[] [[staging]] == Staging -[.filename]#bsd.port.mk# ожидает от портов работу с "каталогом сборки". Это означает, что порт должен устанавливать файлы не напрямую в назначенные каталоги (то есть, например, под `PREFIX`), а в отдельный каталог, из которого затем собирается пакет. Во многих случаях привилегии root для этого не требуются, что делает возможным сборку пакетов из-под непривилегированного пользователя. В режиме staging порт собирается и устанавливается в каталог сборки `STAGEDIR`. Пакет создается из каталога сборки и затем устанавливается в систему. В инструментарии automake такая концеп ция именуется `DESTDIR`; в прочем, в FreeBSD `DESTDIR` имеет собственное значение (смотрите <>). +[.filename]#bsd.port.mk# ожидает от портов работу с "каталогом сборки". Это означает, что порт должен устанавливать файлы не напрямую в назначенные каталоги (то есть, например, под `PREFIX`), а в отдельный каталог, из которого затем собирается пакет. Во многих случаях привилегии root для этого не требуются, что делает возможным сборку пакетов из-под непривилегированного пользователя. В режиме staging порт собирается и устанавливается в каталог сборки `STAGEDIR`. Пакет создается из каталога сборки и затем устанавливается в систему. В инструментарии automake такая концеп ция именуется `DESTDIR`; в прочем, в FreeBSD `DESTDIR` имеет собственное значение (смотрите crossref:testing[porting-prefix, `PREFIX` и `DESTDIR`]). Если для порта всё ещё требуются системные привилегии при выполнении цели `package`, то в [.filename]#Makefile# должна быть добавлена следующая строка: @@ -425,7 +425,7 @@ USE_AUTOTOOLS= aclocal:version === Простой вариант использования -Если для вашего порта требуется `gettext`, добавьте `USES= gettext`, и ваш порт унаследует зависимость от package:devel/gettext[]. <> содержит перечень других значений для использования `gettext`. +Если для вашего порта требуется `gettext`, добавьте `USES= gettext`, и ваш порт унаследует зависимость от package:devel/gettext[]. crossref:makefiles[uses-makefiles, `USES`] содержит перечень других значений для использования `gettext`. Довольно распространенным случаем является использование в порте `gettext` и `configure`. Как правило, GNU `configure` способен находить `gettext` автоматически. Если он все же не сможет это сделать, то подсказки для размещения `gettext` можно передать через переменные окружения `CPPFLAGS` и `LDFLAGS`: @@ -1103,7 +1103,7 @@ USE_QT4= moc_build qmake_build rcc_build uic_build |Каталог, в который устанавливаются JAR-файлы из других портов. По умолчанию: [.filename]#${LOCALBASE}/shared/java/classes#. |=== -Соответствующие записи определяются в обоих переменных `PLIST_SUB` (описана в <>) и `SUB_LIST`. +Соответствующие записи определяются в обоих переменных `PLIST_SUB` (описана в crossref:plist[plist-sub,Изменение содержимого pkg-plist в зависимости от make-переменных]) и `SUB_LIST`. [[java-building-with-ant]] === Построение с Ant @@ -1141,7 +1141,7 @@ do-install: Вне зависимости от типа вашего порта (библиотека это или приложение), дополнительная документация должна устанавливаться <>, что и для других портов. Известно, что в зависимости от используемой версии JDK утилита JavaDoc генерирует различные наборы файлов. Для портов, которые не привязаны к использованию определённой версии JDK, таким образом становится проблематичным определить список файлов для упаковки ([.filename]#pkg-plist#). Это одна из причин, по которой создателям портов настоятельно рекомендуется использовать мак ос `PORTDOCS`. Более того, даже если вы сможете угадать набор файлов, который будет сгенерирован утилитой `javadoc`, размер получающегося файла [.filename]#pkg-plist# голосует за использование `PORTDOCS`. -Значением по умолчанию для переменной `DATADIR` является [.filename]#${PREFIX}/shared/${PORTNAME}#. Хорошей идеей является переопределение для Java-портов значения `DATADIR` как [.filename]#${JAVASHAREDIR}/${PORTNAME}#. На самом деле `DATADIR` автоматически добавляется к `PLIST_SUB` (это описано в <>), так что вы сможете использовать `%%DATADIR%%` непосредственно в [.filename]#pkg-plist#. +Значением по умолчанию для переменной `DATADIR` является [.filename]#${PREFIX}/shared/${PORTNAME}#. Хорошей идеей является переопределение для Java-портов значения `DATADIR` как [.filename]#${JAVASHAREDIR}/${PORTNAME}#. На самом деле `DATADIR` автоматически добавляется к `PLIST_SUB` (это описано в crossref:plist[plist-sub,Изменение содержимого pkg-plist в зависимости от make-переменных]), так что вы сможете использовать `%%DATADIR%%` непосредственно в [.filename]#pkg-plist#. Что касается выбора между построением портов Java из исходных текстов или их прямой установкой из бинарных дистрибутивов, то на момент создания этого текста определённой политики на этот счёт не существует. Однако участники http://www.freebsd.org/java/[Проекта FreeBSD Java] рекомендуют создателям портов строить их из исходных текстов, если эта задача является несложной. @@ -1149,7 +1149,7 @@ do-install: Хотя в базе сообщений об ошибках для соответствующих PR имеется категория `java`, она относится к работе над портированием JDK, которые проводит Проект FreeBSD Java. Таким образом, вы должны относить свой Java-порт, как и любой другой, к категории `ports`, если решаемый вами вопрос не относится ни к реализации JDK, ни к [.filename]#bsd.java.mk#. -Похожим образом определена политика по отношению к `CATEGORIES` порта Java, которая подробно описана в <>. +Похожим образом определена политика по отношению к `CATEGORIES` порта Java, которая подробно описана в crossref:makefiles[makefile-categories, Разделение по категориям]. [[using-php]] == Веб-приложения, Apache и PHP diff --git a/documentation/content/ru/books/porters-handbook/testing/chapter.adoc b/documentation/content/ru/books/porters-handbook/testing/_index.adoc similarity index 92% rename from documentation/content/ru/books/porters-handbook/testing/chapter.adoc rename to documentation/content/ru/books/porters-handbook/testing/_index.adoc index 98b7c82e1f..a40e23725e 100644 --- a/documentation/content/ru/books/porters-handbook/testing/chapter.adoc +++ b/documentation/content/ru/books/porters-handbook/testing/_index.adoc @@ -49,7 +49,7 @@ endif::[] [NOTE] ==== -Возможность генерировать этот файл очень важна вне зависимости от того, какие параметры присутствуют в [.filename]#make.conf#, поэтому, пожалуйста, избегайте, таких вещей, как использование декларации `.error`, когда (к примеру) требования к зависимости не было удовлетворено. (Смотрите <>.) +Возможность генерировать этот файл очень важна вне зависимости от того, какие параметры присутствуют в [.filename]#make.conf#, поэтому, пожалуйста, избегайте, таких вещей, как использование декларации `.error`, когда (к примеру) требования к зависимости не было удовлетворено. (Смотрите crossref:porting-dads[dads-dot-error, Избегайте использования конструкции `.error`].) ==== Если `make describe` выдаёт строчку, а не ошибку, то для вас это пройдёт безболезненно. Обратитесь к файлу [.filename]#bsd.port.mk#, чтобы выяснить значение выдаваемых строк. @@ -59,7 +59,7 @@ endif::[] [[testing-portlint]] == Portlint -Проверьте свою работу командой <> перед тем, как её отослать или перенести в дерево портов. `portlint` предупреждает вас о многих распространённых ошибках, как функциональных, так и стилистических. Для нового (или скопированного внутри хранилища) порта самым подходящим является запуск `portlint -A`; для уже существующего порта достаточно будет запустить `portlint -C`. +Проверьте свою работу командой crossref:quick-porting[porting-portlint,`portlint`] перед тем, как её отослать или перенести в дерево портов. `portlint` предупреждает вас о многих распространённых ошибках, как функциональных, так и стилистических. Для нового (или скопированного внутри хранилища) порта самым подходящим является запуск `portlint -A`; для уже существующего порта достаточно будет запустить `portlint -C`. Так как для обнаружения ошибок `portlint` использует эвристические методы, то им могут выдаваться и ошибочные предупреждения. Кроме того, время от времени нечто, отмечаемое как некорректность, из-за ограничений механизма создания портов не может быть сделано никак иначе. Если вы сомневаетесь, то лучше всего спросить в {freebsd-ports}. @@ -95,7 +95,7 @@ endif::[] Если что-то было установлено за пределами `PREFIX`, то процесс создания пакета сообщит об отсутствии файлов. -Это также стоит проверить с использованием поддержки каталога сборки (смотрите <>): +Это также стоит проверить с использованием поддержки каталога сборки (смотрите crossref:special[staging, Staging]): [source,shell] .... diff --git a/documentation/content/ru/books/porters-handbook/upgrading/chapter.adoc b/documentation/content/ru/books/porters-handbook/upgrading/_index.adoc similarity index 98% rename from documentation/content/ru/books/porters-handbook/upgrading/chapter.adoc rename to documentation/content/ru/books/porters-handbook/upgrading/_index.adoc index 8996df3362..6314418994 100644 --- a/documentation/content/ru/books/porters-handbook/upgrading/chapter.adoc +++ b/documentation/content/ru/books/porters-handbook/upgrading/_index.adoc @@ -79,7 +79,7 @@ endif::[] Повторяем еще раз - для посылки обновлений существующих портов используйте утилиту man:diff[1], а не man:shar[1]! Это поможет понять коммиттерам портов, что именно было изменено. ==== -Теперь, когда вы проделали всё это, прочитайте о том, как поддерживать актуальное состояние, в <>. +Теперь, когда вы проделали всё это, прочитайте о том, как поддерживать актуальное состояние, в crossref:keeping-up[keeping-up, Актуализация]. [[svn-diff]] == Использование Subversion для создания патчей @@ -105,7 +105,7 @@ endif::[] % svn remove deleted_file .... -Убедитесь, что вы проверяете порт в соответствии с рекомендуемым порядком проверки, описанным в <> и <>. +Убедитесь, что вы проверяете порт в соответствии с рекомендуемым порядком проверки, описанным в crossref:quick-porting[porting-testing, Тестирование порта] и crossref:quick-porting[porting-portlint, Проверка вашего порта утилитой `portlint`]. [source,shell] .... diff --git a/documentation/content/ru/books/porters-handbook/uses/chapter.adoc b/documentation/content/ru/books/porters-handbook/uses/_index.adoc similarity index 55% rename from documentation/content/ru/books/porters-handbook/uses/chapter.adoc rename to documentation/content/ru/books/porters-handbook/uses/_index.adoc index 2862084668..b9944e68d9 100644 --- a/documentation/content/ru/books/porters-handbook/uses/chapter.adoc +++ b/documentation/content/ru/books/porters-handbook/uses/_index.adoc @@ -46,56 +46,51 @@ endif::[] [[uses-intro]] == An Introduction to `USES` -`USES` macros make it easy to declare requirements and settings for a port. They can add dependencies, change building behavior, add metadata to packages, and so on, all by selecting simple, preset values. +`USES` macros make it easy to declare requirements and settings for a port. +They can add dependencies, change building behavior, add metadata to packages, and so on, all by selecting simple, preset values. -Each section in this chapter describes a possible value for `USES`, along with its possible arguments. Arguments are appeneded to the value after a colon (`:`). Multiple arguments are separated by commas (`,`). +Each section in this chapter describes a possible value for `USES`, along with its possible arguments. +Arguments are appended to the value after a colon (`:`). +Multiple arguments are separated by commas (`,`). [[uses-intro-ex1]] .Using Multiple Values [example] ==== - [.programlisting] .... USES= bison perl .... - ==== [[uses-intro-ex2]] .Adding an Argument [example] ==== - [.programlisting] .... USES= tar:xz .... - ==== [[uses-intro-ex3]] .Adding Multiple Arguments [example] ==== - [.programlisting] .... USES= drupal:7,theme .... - ==== [[uses-intro-ex4]] .Mixing it All Together [example] ==== - [.programlisting] .... USES= pgsql:9.3+ cpe python:2.7,build .... - ==== [[uses-7z]] @@ -103,21 +98,30 @@ USES= pgsql:9.3+ cpe python:2.7,build Possible arguments: (none), `p7zip`, `partial` -Extract using man:7z[1] instead of man:bsdtar[1] and sets `EXTRACT_SUFX=.7z`. The `p7zip` option forces a dependency on the `7z` from package:archivers/p7zip[] if the one from the base system is not able to extract the files. `EXTRACT_SUFX` is not changed if the `partial` option is used, this can be used if the main distribution file does not have a [.filename]#.7z# extension. +Extract using man:7z[1] instead of man:bsdtar[1] and sets `EXTRACT_SUFX=.7z`. +The `p7zip` option forces a dependency on the `7z` from package:archivers/p7zip[] if the one from the base system is not able to extract the files. +`EXTRACT_SUFX` is not changed if the `partial` option is used, this can be used if the main distribution file does not have a [.filename]#.7z# extension. [[uses-ada]] == `ada` Possible arguments: (none), `5`, `6` -Depends on an Ada-capable compiler, and sets `CC` accordingly. Defaults to use gcc 5 from ports. Use the `:__X__` version option to force building with a different version. +Depends on an Ada-capable compiler, and sets `CC` accordingly. +Defaults to use gcc 5 from ports. +Use the `:_X_` version option to force building with a different version. [[uses-autoreconf]] == `autoreconf` Possible arguments: (none), `build` -Runs `autoreconf`. It encapsulates the `aclocal`, `autoconf`, `autoheader`, `automake`, `autopoint`, and `libtoolize` commands. Each command applies to [.filename]#${AUTORECONF_WRKSRC}/configure.ac# or its old name, [.filename]#${AUTORECONF_WRKSRC}/configure.in#. If [.filename]#configure.ac# defines subdirectories with their own [.filename]#configure.ac# using `AC_CONFIG_SUBDIRS`, `autoreconf` will recursively update those as well. The `:build` argument only adds build time dependencies on those tools but does not run `autoreconf`. A port can set `AUTORECONF_WRKSRC` if `WRKSRC` does not contain the path to [.filename]#configure.ac#. +Runs `autoreconf`. +It encapsulates the `aclocal`, `autoconf`, `autoheader`, `automake`, `autopoint`, and `libtoolize` commands. +Each command applies to [.filename]#${AUTORECONF_WRKSRC}/configure.ac# or its old name, [.filename]#${AUTORECONF_WRKSRC}/configure.in#. +If [.filename]#configure.ac# defines subdirectories with their own [.filename]#configure.ac# using `AC_CONFIG_SUBDIRS`, `autoreconf` will recursively update those as well. +The `:build` argument only adds build time dependencies on those tools but does not run `autoreconf`. +A port can set `AUTORECONF_WRKSRC` if `WRKSRC` does not contain the path to [.filename]#configure.ac#. [[uses-blaslapack]] == `blaslapack` @@ -131,26 +135,37 @@ Adds dependencies on Blas / Lapack libraries. Possible arguments: (none), `48`, `5` (default), `6` -Add dependency on the Berkeley DB library. Default to package:databases/db5[]. It can also depend on package:databases/db48[] when using the `:48` argument or package:databases/db6[] with `:6`. It is possible to declare a range of acceptable values, `:48+` finds the highest installed version, and falls back to 4.8 if nothing else is installed. `INVALID_BDB_VER` can be used to specify versions which do not work with this port. The framework exposes the following variables to the port: +Add dependency on the Berkeley DB library. +Default to package:databases/db5[]. +It can also depend on package:databases/db48[] when using the `:48` argument or package:databases/db6[] with `:6`. +It is possible to declare a range of acceptable values, `:48+` finds the highest installed version, and falls back to 4.8 if nothing else is installed. +`INVALID_BDB_VER` can be used to specify versions which do not work with this port. +The framework exposes the following variables to the port: `BDB_LIB_NAME`:: -The name of the Berkeley DB library. For example, when using package:databases/db5[], it contains `db-5.3`. +The name of the Berkeley DB library. +For example, when using package:databases/db5[], it contains `db-5.3`. `BDB_LIB_CXX_NAME`:: -The name of the Berkeley DBC++ library. For example, when using package:databases/db5[], it contains `db_cxx-5.3`. +The name of the Berkeley DBC++ library. +For example, when using package:databases/db5[], it contains `db_cxx-5.3`. `BDB_INCLUDE_DIR`:: -The location of the Berkeley DB include directory. For example, when using package:databases/db5[], it will contain `${LOCALBASE}/include/db5`. +The location of the Berkeley DB include directory. +For example, when using package:databases/db5[], it will contain `${LOCALBASE}/include/db5`. `BDB_LIB_DIR`:: -The location of the Berkeley DB library directory. For example, when using package:databases/db5[], it contains `${LOCALBASE}/lib`. +The location of the Berkeley DB library directory. +For example, when using package:databases/db5[], it contains `${LOCALBASE}/lib`. `BDB_VER`:: -The detected Berkeley DB version. For example, if using `USES=bdb:48+` and Berkeley DB 5 is installed, it contains `5`. +The detected Berkeley DB version. +For example, if using `USES=bdb:48+` and Berkeley DB 5 is installed, it contains `5`. [IMPORTANT] ==== -package:databases/db48[] is deprecated and unsupported. It must not be used by any port. +package:databases/db48[] is deprecated and unsupported. +It must not be used by any port. ==== [[uses-bison]] @@ -165,23 +180,32 @@ Uses package:devel/bison[] By default, with no arguments or with the `build` arg [IMPORTANT] ==== -Ports should not be created for Haskell libraries, see <> for more information. +Ports should not be created for Haskell libraries, see crossref:special[haskell-libs,Haskell Libraries] for more information. ==== Possible arguments: (none), `hpack` -Sets default values and targets used to build Haskell software using Cabal. A build dependency on the Haskell compiler port (GHC) is added. If `hpack` argument is given, a build dependency on package:devel/hs-hpack[] is added and `hpack` is invoked at configuration step to generate .cabal file. +Sets default values and targets used to build Haskell software using Cabal. +A build dependency on the Haskell compiler port (GHC) is added. +If `hpack` argument is given, a build dependency on package:devel/hs-hpack[] is added and `hpack` is invoked at configuration step to generate. +cabal file. The framework provides the following variables: `USE_CABAL`:: -If the software uses Haskell dependencies, list them in this variable. Each item should be present on Hackage and be listed in form `packagename-_0.1.2_`. Dependencies can have revisions, which are specified after the `_` symbol. Automatic generation of dependency list is supported, see <>. +If the software uses Haskell dependencies, list them in this variable. +Each item should be present on Hackage and be listed in form `packagename-_0.1.2_`. +Dependencies can have revisions, which are specified after the `_` symbol. +Automatic generation of dependency list is supported, see crossref:special[using-cabal,Building Haskell Applications with `cabal`]. `CABAL_FLAGS`:: -List of flags to be passed to `cabal-install` during the configuring and building stage. The flags are passed verbatim. +List of flags to be passed to `cabal-install` during the configuring and building stage. +The flags are passed verbatim. `EXECUTABLES`:: -List of executable files installed by the port. Default value: `${PORTNAME}`. Items from this list are automatically added to pkg-plist. +List of executable files installed by the port. +Default value: `${PORTNAME}`. +Items from this list are automatically added to pkg-plist. `SKIP_CABAL_PLIST`:: If defined, do not add items from `${EXECUTABLES}` to pkg-plist. @@ -193,7 +217,8 @@ Adds items to `${USE_CABAL}` depending on `opt` option. Adds items to `${EXECUTABLES}` depending on `opt` option. `opt_CABAL_FLAGS`:: -If `opt` is enabled, append the value to `${CABAL_FLAGS}`. Otherwise, append `-value` to disable the flag. +If `opt` is enabled, append the value to `${CABAL_FLAGS}`. +Otherwise, append `-value` to disable the flag. `FOO_DATADIR_VARS`:: For an executable named `FOO` list Haskell packages, whose data files should be accessible by the executable. @@ -203,38 +228,53 @@ For an executable named `FOO` list Haskell packages, whose data files should be Possible arguments: (none) -Uses Cargo for configuring, building, and testing. It can be used to port Rust applications that use the Cargo build system. For more information see <>. +Uses Cargo for configuring, building, and testing. +It can be used to port Rust applications that use the Cargo build system. +For more information see crossref:special[using-cargo,Building Rust Applications with `cargo`]. [[uses-charsetfix]] == `charsetfix` Possible arguments: (none) -Prevents the port from installing [.filename]#charset.alias#. This must be installed only by package:converters/libiconv[]. `CHARSETFIX_MAKEFILEIN` can be set to a path relative to `WRKSRC` if [.filename]#charset.alias# is not installed by [.filename]#${WRKSRC}/Makefile.in#. +Prevents the port from installing [.filename]#charset.alias#. +This must be installed only by package:converters/libiconv[]. +`CHARSETFIX_MAKEFILEIN` can be set to a path relative to `WRKSRC` if [.filename]#charset.alias# is not installed by [.filename]#${WRKSRC}/Makefile.in#. [[uses-cmake]] == `cmake` -Possible arguments: (none), `insource`, `noninja`, `run` +Possible arguments: (none), `insource`, `noninja`, `run`, `testing` -Uses CMake for configuring and building. +Use CMake for configuring the port and generating a build system. -By default an out-of-source build is performed, leaving the sources in `WRKSRC` free from build artifacts. With the `insource` argument, an in-source build will be performed instead. Setting it should be the exception when a regular out-of-source build does not work. +By default an out-of-source build is performed, leaving the sources in `WRKSRC` free from build artifacts. +With the `insource` argument, an in-source build will be performed instead. +This argument should be an exception, used only when a regular out-of-source build does not work. -By default Ninja is used for the build. In some cases this does not work correctly. With the `noninja` argument, the build will fallback to using regular `make` for builds. It should only be used if a Ninja-based build does not work. +By default Ninja (package:devel/ninja[]) is used for the build. +In some cases this does not work correctly. +With the `noninja` argument, the build will use regular `make` for builds. +This argument should only be used if a Ninja-based build does not work. With the `run` argument, a run dependency is registered in addition to a build dependency. -For more information see <>. +With the `testing` argument, a test-target is added that uses CTest. +When running tests the port will be re-configured for testing and re-built. + +For more information see crossref:special[using-cmake,Using `cmake`]. [[uses-compiler]] == `compiler` -Possible arguments: (none), `env` (default, implicit), `{c-plus-plus}17-lang`, `{c-plus-plus}14-lang`, `{c-plus-plus}11-lang`, `gcc-{c-plus-plus}11-lib`, `{c-plus-plus}11-lib`, `{c-plus-plus}0x`, `c11`, `openmp`, `nestedfct`, `features` +Possible arguments: (none), `env` (default, implicit), `{c-plus-plus}17-lang`, `{c-plus-plus}14-lang`, `{c-plus-plus}11-lang`, `gcc-{c-plus-plus}11-lib`, `{c-plus-plus}11-lib`, `{c-plus-plus}0x`, `c11`, `nestedfct`, `features` -Determines which compiler to use based on any given wishes. Use `{c-plus-plus}17-lang` if the port needs a {c-plus-plus}17-capable compiler, `{c-plus-plus}14-lang` if the port needs a {c-plus-plus}14-capable compiler, `{c-plus-plus}11-lang` if the port needs a {c-plus-plus}11-capable compiler, `gcc-{c-plus-plus}11-lib` if the port needs the `g++` compiler with a {c-plus-plus}11 library, or `{c-plus-plus}11-lib` if the port needs a {c-plus-plus}11-ready standard library. If the port needs a compiler understanding {c-plus-plus}0X, C11, OpenMP, or nested functions, the corresponding parameters should be used. +Determines which compiler to use based on any given wishes. +Use `{c-plus-plus}17-lang` if the port needs a {c-plus-plus}17-capable compiler, `{c-plus-plus}14-lang` if the port needs a {c-plus-plus}14-capable compiler, `{c-plus-plus}11-lang` if the port needs a {c-plus-plus}11-capable compiler, `gcc-{c-plus-plus}11-lib` if the port needs the `g++` compiler with a {c-plus-plus}11 library, or `{c-plus-plus}11-lib` if the port needs a {c-plus-plus}11-ready standard library. +If the port needs a compiler understanding {c-plus-plus}0X, C11 or nested functions, the corresponding parameters should be used. -Use `features` to request a list of features supported by the default compiler. After including [.filename]#bsd.port.pre.mk# the port can inspect the results using these variables: +Use `features` to request a list of features supported by the default compiler. +After including [.filename]#bsd.port.pre.mk# the port can inspect the results using these variables: * `COMPILER_TYPE`: the default compiler on the system, either gcc or clang * `ALT_COMPILER_TYPE`: the alternative compiler on the system, either gcc or clang. Only set if two compilers are present in the base system. @@ -248,10 +288,11 @@ Use `features` to request a list of features supported by the default compiler. Possible arguments: (none) -Include Common Platform Enumeration (CPE) information in package manifest as a CPE 2.3 formatted string. See the http://scap.nist.gov/specifications/cpe/[CPE specification] for details. To add CPE information to a port, follow these steps: +Include Common Platform Enumeration (CPE) information in package manifest as a CPE 2.3 formatted string. +See the http://scap.nist.gov/specifications/cpe/[CPE specification] for details. +To add CPE information to a port, follow these steps: [.procedure] -==== . Search for the official CPE entry for the software product either by using the NVD's http://web.nvd.nist.gov/view/cpe/search[CPE search engine] or in the http://static.nvd.nist.gov/feeds/xml/cpe/dictionary/official-cpe-dictionary_v2.3.xml[official CPE dictionary] (warning, very large XML file). _Do not ever make up CPE data._ . Add `cpe` to `USES` and compare the result of `make -V CPE_STR` to the CPE dictionary entry. Continue one step at a time until `make -V CPE_STR` is correct. . If the product name (second field, defaults to `PORTNAME`) is incorrect, define `CPE_PRODUCT`. @@ -261,21 +302,24 @@ Include Common Platform Enumeration (CPE) information in package manifest as a C . If it is still not correct, check [.filename]#Mk/Uses/cpe.mk# for additional details, or contact the {ports-secteam}. . Derive as much as possible of the CPE name from existing variables such as `PORTNAME` and `PORTVERSION`. Use variable modifiers to extract the relevant portions from these variables rather than hardcoding the name. . _Always_ run `make -V CPE_STR` and check the output before committing anything that changes `PORTNAME` or `PORTVERSION` or any other variable which is used to derive `CPE_STR`. -==== [[uses-cran]] == `cran` Possible arguments: (none), `auto-plist`, `compiles` -Uses the Comprehensive R Archive Network. Specify `auto-plist` to automatically generate [.filename]#pkg-plist#. Specify `compiles` if the port has code that need to be compiled. +Uses the Comprehensive R Archive Network. +Specify `auto-plist` to automatically generate [.filename]#pkg-plist#. +Specify `compiles` if the port has code that need to be compiled. [[uses-desktop-file-utils]] == `desktop-file-utils` Possible arguments: (none) -Uses update-desktop-database from package:devel/desktop-file-utils[]. An extra post-install step will be run without interfering with any post-install steps already in the port [.filename]#Makefile#. A line with <> will be added to the plist. +Uses update-desktop-database from package:devel/desktop-file-utils[]. +An extra post-install step will be run without interfering with any post-install steps already in the port [.filename]#Makefile#. +A line with <> will be added to the plist. [[uses-desthack]] == `desthack` @@ -289,14 +333,19 @@ Changes the behavior of GNU configure to properly support `DESTDIR` in case the Possible arguments: (none), _ARGS_ -Set up a virtual display environment. If the environment variable `DISPLAY` is not set, then Xvfb is added as a build dependency, and `CONFIGURE_ENV` is extended with the port number of the currently running instance of Xvfb. The _ARGS_ parameter defaults to `install` and controls the phase around which to start and stop the virtual display. +Set up a virtual display environment. +If the environment variable `DISPLAY` is not set, then Xvfb is added as a build dependency, and `CONFIGURE_ENV` is extended with the port number of the currently running instance of Xvfb. +The _ARGS_ parameter defaults to `install` and controls the phase around which to start and stop the virtual display. [[uses-dos2unix]] == `dos2unix` Possible arguments: (none) -The port has files with line endings in DOS format which need to be converted. Several variables can be set to control which files will be converted. The default is to convert _all_ files, including binaries. See <> for examples. +The port has files with line endings in DOS format which need to be converted. +Several variables can be set to control which files will be converted. +The default is to convert _all_ files, including binaries. +See crossref:slow-porting[slow-patch-automatic-replacements,Simple Automatic Replacements] for examples. * `DOS2UNIX_REGEX`: match file names based on a regular expression. * `DOS2UNIX_FILES`: match literal file names. @@ -308,21 +357,33 @@ The port has files with line endings in DOS format which need to be converted. S Possible arguments: `7`, `module`, `theme` -Automate installation of a port that is a Drupal theme or module. Use with the version of Drupal that the port is expecting. For example, `USES=drupal:7,module` says that this port creates a Drupal 6 module. A Drupal 7 theme can be specified with `USES=drupal:7,theme`. +Automate installation of a port that is a Drupal theme or module. +Use with the version of Drupal that the port is expecting. +For example, `USES=drupal:7,module` says that this port creates a Drupal 6 module. +A Drupal 7 theme can be specified with `USES=drupal:7,theme`. + +[[uses-eigen]] +== `eigen` + +Possible arguments: 2, 3, build (default), run + +Add dependency on package:math/eigen[]. [[uses-fakeroot]] == `fakeroot` Possible arguments: (none) -Changes some default behavior of build systems to allow installing as a user. See https://wiki.debian.org/FakeRoot[] for more information on `fakeroot`. +Changes some default behavior of build systems to allow installing as a user. +See https://wiki.debian.org/FakeRoot[] for more information on `fakeroot`. [[uses-fam]] == `fam` Possible arguments: (none), `fam`, `gamin` -Uses a File Alteration Monitor as a library dependency, either package:devel/fam[] or package:devel/gamin[]. End users can set WITH_FAM_SYSTEM to specify their preference. +Uses a File Alteration Monitor as a library dependency, either package:devel/fam[] or package:devel/gamin[]. +End users can set WITH_FAM_SYSTEM to specify their preference. [[uses-firebird]] == `firebird` @@ -336,7 +397,10 @@ Add a dependency to the client library of the Firebird database. Possible arguments: (none), `fc`, `fcfontsdir` (default), `fontsdir`, `none` -Adds a runtime dependency on tools needed to register fonts. Depending on the argument, add a `<> ${FONTSDIR}` line, `<> ${FONTSDIR}` line, `<> ${FONTSDIR}` line, or no line if the argument is `none`, to the plist. `FONTSDIR` defaults to [.filename]#${PREFIX}/shared/fonts/${FONTNAME}# and `FONTNAME` to `${PORTNAME}`. Add `FONTSDIR` to `PLIST_SUB` and `SUB_LIST` +Adds a runtime dependency on tools needed to register fonts. +Depending on the argument, add a `crossref:plist[plist-keywords-fc,@fc] ${FONTSDIR}` line, `crossref:plist[plist-keywords-fcfontsdir,@fcfontsdir] ${FONTSDIR}` line, `crossref:plist[plist-keywords-fontsdir,@fontsdir] ${FONTSDIR}` line, or no line if the argument is `none`, to the plist. +`FONTSDIR` defaults to [.filename]#${PREFIX}/share/fonts/${FONTNAME}# and `FONTNAME` to `${PORTNAME}`. +Add `FONTSDIR` to `PLIST_SUB` and `SUB_LIST` [[uses-fortran]] == `fortran` @@ -357,42 +421,53 @@ The port will depend on the FUSE library and handle the dependency on the kernel Possible arguments: (none), `noautoplist` -Handle building with RubyGems. If `noautoplist` is used, the packing list is not generated automatically. +Handle building with RubyGems. +If `noautoplist` is used, the packing list is not generated automatically. [[uses-gettext]] == `gettext` Possible arguments: (none) -Deprecated. Will include both <> and <>. +Deprecated. +Will include both <> and <>. [[uses-gettext-runtime]] == `gettext-runtime` Possible arguments: (none), `lib` (default), `build`, `run` -Uses package:devel/gettext-runtime[]. By default, with no arguments or with the `lib` argument, implies a library dependency on [.filename]#libintl.so#. `build` and `run` implies, respectively a build-time and a run-time dependency on [.filename]#gettext#. +Uses package:devel/gettext-runtime[]. +By default, with no arguments or with the `lib` argument, implies a library dependency on [.filename]#libintl.so#. +`build` and `run` implies, respectively a build-time and a run-time dependency on [.filename]#gettext#. [[uses-gettext-tools]] == `gettext-tools` Possible arguments: (none), `build` (default), `run` -Uses package:devel/gettext-tools[]. By default, with no argument, or with the `build` argument, a build time dependency on [.filename]#msgfmt# is registered. With the `run` argument, a run-time dependency is registered. +Uses package:devel/gettext-tools[]. +By default, with no argument, or with the `build` argument, a build time dependency on [.filename]#msgfmt# is registered. +With the `run` argument, a run-time dependency is registered. [[uses-ghostscript]] == `ghostscript` Possible arguments: _X_, `build`, `run`, `nox11` -A specific version _X_ can be used. Possible versions are `7`, `8`, `9`, and `agpl` (default). `nox11` indicates that the `-nox11` version of the port is required. `build` and `run` add build- and run-time dependencies on Ghostscript. The default is both build- and run-time dependencies. +A specific version _X_ can be used. Possible versions are `7`, `8`, `9`, and `agpl` (default). +`nox11` indicates that the `-nox11` version of the port is required. +`build` and `run` add build- and run-time dependencies on Ghostscript. +The default is both build- and run-time dependencies. [[uses-gl]] == `gl` Possible arguments: (none) -Provides an easy way to depend on GL components. The components should be listed in `USE_GL`. The available components are: +Provides an easy way to depend on GL components. +The components should be listed in `USE_GL`. +The available components are: `egl`:: add a library dependency on [.filename]#libEGL.so# from package:graphics/libglvnd[] @@ -430,7 +505,9 @@ Uses package:devel/gmake[] as a build-time dependency and sets up the environmen Possible arguments: (none) -Provides an easy way to depend on GNOME components. The components should be listed in `USE_GNOME`. The available components are: +Provides an easy way to depend on GNOME components. +The components should be listed in `USE_GNOME`. +The available components are: * `atk` * `atkmm` @@ -514,7 +591,8 @@ Provides an easy way to depend on GNOME components. The components should be lis * `vte` * `vte3` -The default dependency is build- and run-time, it can be changed with `:build` or `:run`. For example: +The default dependency is build- and run-time, it can be changed with `:build` or `:run`. +For example: [.programlisting] .... @@ -522,30 +600,45 @@ USES= gnome USE_GNOME= gnomemenus3:build intlhack .... -See <> for more information. +See crossref:special[using-gnome,Using GNOME] for more information. [[uses-go]] == `go` [IMPORTANT] ==== -Ports should not be created for Go libs, see <> for more information. +Ports should not be created for Go libs, see crossref:special[go-libs,Go Libraries] for more information. ==== Possible arguments: (none), `modules`, `no_targets`, `run` -Sets default values and targets used to build Go software. A build dependency on the Go compiler port selected via `GO_PORT` is added. By default the build is performed in GOPATH mode. If Go software uses modules, the modules-aware mode can be switched on with `modules` argument. `no_targets` will setup build environment like `GO_ENV`, `GO_BUILDFLAGS` but skip creating `post-extract` and `do-{build,install,test}` targets. `run` will also add a run dependency on what is in `GO_PORT`. +Sets default values and targets used to build Go software. +A build dependency on the Go compiler port selected via `GO_PORT` is added. +By default the build is performed in GOPATH mode. +If Go software uses modules, the modules-aware mode can be switched on with `modules` argument. +`no_targets` will setup build environment like `GO_ENV`, `GO_BUILDFLAGS` but skip creating `post-extract` and `do-{build,install,test}` targets. +`run` will also add a run dependency on what is in `GO_PORT`. The build process is controlled by several variables: +`GO_MODULE`:: +The name of the application module as specified by the `module` directive in `go.mod`. +In most cases, this is the only required variable for ports that use Go modules. + `GO_PKGNAME`:: -The name of the Go package when building in GOPATH mode. This is the directory that will be created in `${GOPATH}/src`. If not set explicitly and `GH_SUBDIR` or `GL_SUBDIR` is present, `GO_PKGNAME` will be inferred from it. It is not needed when building in modules-aware mode. +The name of the Go package when building in GOPATH mode. +This is the directory that will be created in `${GOPATH}/src`. +If not set explicitly and `GH_SUBDIR` or `GL_SUBDIR` is present, `GO_PKGNAME` will be inferred from it. *** 895 LINES SKIPPED *** From nobody Sat Nov 27 13:29:46 2021 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 CCA6918B23BE for ; Sat, 27 Nov 2021 13:29:46 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4J1XXV3pq9z3NDc; Sat, 27 Nov 2021 13:29:46 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 633001C9E2; Sat, 27 Nov 2021 13:29:46 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1ARDTkLR043664; Sat, 27 Nov 2021 13:29:46 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1ARDTkjx043663; Sat, 27 Nov 2021 13:29:46 GMT (envelope-from git) Date: Sat, 27 Nov 2021 13:29:46 GMT Message-Id: <202111271329.1ARDTkjx043663@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: de30e744dc - main - Split Simplified Chinese porter's handbook 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: de30e744dc40621846f0d4b01c0ff89557489a04 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1638019786; 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; bh=WawZBOGq/XQDlXBLpZFMxMCA+6kg2ZK2GbNEja9Y1tw=; b=KLCF99719luR0RgTHwrtNC/SJGgj5HsWwS1cVsrydDPDAAEMNWs+QkNSK8RKZ7+AS3dXbq quLakB+d+yb4b2Mvb+lX5KQCJMz5ujMKYBgH2MeP2wuFXQ9na5dqKwe1eS8QQ6ju2y83fN mRN1UOrV9tiUy8Ny5eRk6pO/pzH9iC+MvRuke2EsOWUFxtdWzy2+u5v4TxusV2EU/hO3kX B9HboATwpZWpiJDprB2FKV6qTQgwwnlBP6XCHqdCMTd4vOHn2vB5zbt4UO3nwMo4BEmUEH vJXnyTdcM6wTpJxBg+E/hzPfnzJjqRBYSmU6dG1jWn4O2PT0GhmrxKpH70t3ug== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1638019786; a=rsa-sha256; cv=none; b=NyWOKgOHXjJy14CIiHPyVjCMGzIs1o4aiDBl8biQs5UOvpr7dFJmixcRUoujZAYgP61L// Qut+3rhPRhYIOumV3UKt9MdL4/Rq8I0xRohLRflZebYxIVlPK1x1SMXzOOAo9v0BukxG2Y cWe/PXyqkhdGcvnGJ2Jz6d0TxjaWzxBBfE6nq9jNgP4G/jITHDR2l8/tkUH2Vv6Q7uFeUy Meb3U8OH8wFR2+u7PiPTaXPHnQydX09Yv3Dqif6usJjXtcUiGglr3q728noaYF1WQmPc0y j4XUzAD8LJlXHY7X/No8bsMwK2aZT+8PqWquOD/C94xyCv2r+FEthuWn6lJ7fQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=de30e744dc40621846f0d4b01c0ff89557489a04 commit de30e744dc40621846f0d4b01c0ff89557489a04 Author: Sergio Carlavilla Delgado AuthorDate: 2021-11-27 13:27:21 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-11-27 13:27:21 +0000 Split Simplified Chinese porter's handbook --- .../zh-cn/books/porters-handbook/_index.adoc | 24 ++------ .../content/zh-cn/books/porters-handbook/book.adoc | 67 ++++++++++++++++++++++ .../books/porters-handbook/chapters-order.adoc | 28 ++++----- .../keeping-up/{chapter.adoc => _index.adoc} | 0 .../makefile/{chapter.adoc => _index.adoc} | 6 +- .../own-port/{chapter.adoc => _index.adoc} | 2 +- .../pkg-files/{chapter.adoc => _index.adoc} | 0 .../plist/{chapter.adoc => _index.adoc} | 0 .../port-upgrading/{chapter.adoc => _index.adoc} | 4 +- .../porting-dads/{chapter.adoc => _index.adoc} | 2 +- .../porting-samplem/{chapter.adoc => _index.adoc} | 0 .../quick-porting/{chapter.adoc => _index.adoc} | 0 .../security/{chapter.adoc => _index.adoc} | 0 .../slow/{chapter.adoc => _index.adoc} | 0 .../special/{chapter.adoc => _index.adoc} | 10 ++-- .../testing/{chapter.adoc => _index.adoc} | 2 +- .../why-port/{chapter.adoc => _index.adoc} | 0 17 files changed, 99 insertions(+), 46 deletions(-) diff --git a/documentation/content/zh-cn/books/porters-handbook/_index.adoc b/documentation/content/zh-cn/books/porters-handbook/_index.adoc index 162fe551a3..ef8f42161c 100644 --- a/documentation/content/zh-cn/books/porters-handbook/_index.adoc +++ b/documentation/content/zh-cn/books/porters-handbook/_index.adoc @@ -5,21 +5,22 @@ authors: - author: FreeBSD 中文计划 copyright: 2000-2020 The FreeBSD Documentation Project trademarks: ["freebsd", "sun", "unix", "general"] +next: books/porters-handbook/why-port +add_single_page_link: true isIndex: true --- = FreeBSD Porter 手册 :doctype: book :toc: macro -:toclevels: 2 +:toclevels: 1 :icons: font :sectnums: :sectnumlevels: 6 :partnums: :source-highlighter: rouge :experimental: -:book: true -:pdf: false +:images-path: books/porters-handbook/ ifdef::env-beastie[] ifdef::backend-html5[] @@ -45,23 +46,8 @@ endif::[] ''' -toc::[] +include::{chapters-path}toc.adoc[] include::{chapters-path}toc-tables.adoc[] include::{chapters-path}toc-examples.adoc[] - -include::{chapters-path}why-port/chapter.adoc[leveloffset=+1] -include::{chapters-path}own-port/chapter.adoc[leveloffset=+1] -include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1] -include::{chapters-path}slow/chapter.adoc[leveloffset=+1] -include::{chapters-path}makefile/chapter.adoc[leveloffset=+1] -include::{chapters-path}special/chapter.adoc[leveloffset=+1] -include::{chapters-path}plist/chapter.adoc[leveloffset=+1] -include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1] -include::{chapters-path}testing/chapter.adoc[leveloffset=+1] -include::{chapters-path}port-upgrading/chapter.adoc[leveloffset=+1] -include::{chapters-path}security/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1] -include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1] diff --git a/documentation/content/zh-cn/books/porters-handbook/book.adoc b/documentation/content/zh-cn/books/porters-handbook/book.adoc new file mode 100644 index 0000000000..3e0348636f --- /dev/null +++ b/documentation/content/zh-cn/books/porters-handbook/book.adoc @@ -0,0 +1,67 @@ +--- +title: FreeBSD Porter 手册 +authors: + - author: The FreeBSD Documentation Project + - author: FreeBSD 中文计划 +copyright: 2000-2020 The FreeBSD Documentation Project +trademarks: ["freebsd", "sun", "unix", "general"] +add_split_page_link: true +--- + += FreeBSD Porter 手册 +:doctype: book +:toc: macro +:toclevels: 2 +:icons: font +:sectnums: +:sectnumlevels: 6 +:partnums: +:source-highlighter: rouge +:experimental: +:book: true +:pdf: false + +ifdef::env-beastie[] +ifdef::backend-html5[] +include::shared/authors.adoc[] +include::shared/mirrors.adoc[] +include::shared/releases.adoc[] +include::shared/attributes/attributes-{{% lang %}}.adoc[] +include::shared/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/urls.adoc[] +:chapters-path: content/{{% lang %}}/books/porters-handbook/ +endif::[] +ifdef::backend-pdf,backend-epub3[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] +endif::[] + +ifndef::env-beastie[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] + +''' + +toc::[] + +include::{chapters-path}toc-tables.adoc[] + +include::{chapters-path}toc-examples.adoc[] + +include::{chapters-path}why-port/_index.adoc[leveloffset=+1] +include::{chapters-path}own-port/_index.adoc[leveloffset=+1] +include::{chapters-path}quick-porting/_index.adoc[leveloffset=+1] +include::{chapters-path}slow/_index.adoc[leveloffset=+1] +include::{chapters-path}makefile/_index.adoc[leveloffset=+1] +include::{chapters-path}special/_index.adoc[leveloffset=+1] +include::{chapters-path}plist/_index.adoc[leveloffset=+1] +include::{chapters-path}pkg-files/_index.adoc[leveloffset=+1] +include::{chapters-path}testing/_index.adoc[leveloffset=+1] +include::{chapters-path}port-upgrading/_index.adoc[leveloffset=+1] +include::{chapters-path}security/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-dads/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-samplem/_index.adoc[leveloffset=+1] +include::{chapters-path}keeping-up/_index.adoc[leveloffset=+1] diff --git a/documentation/content/zh-cn/books/porters-handbook/chapters-order.adoc b/documentation/content/zh-cn/books/porters-handbook/chapters-order.adoc index 1063d23868..5b56462bca 100644 --- a/documentation/content/zh-cn/books/porters-handbook/chapters-order.adoc +++ b/documentation/content/zh-cn/books/porters-handbook/chapters-order.adoc @@ -1,14 +1,14 @@ -why-port/chapter.adoc -own-port/chapter.adoc -quick-porting/chapter.adoc -slow/chapter.adoc -makefile/chapter.adoc -special/chapter.adoc -plist/chapter.adoc -pkg-files/chapter.adoc -testing/chapter.adoc -port-upgrading/chapter.adoc -security/chapter.adoc -porting-dads/chapter.adoc -porting-samplem/chapter.adoc -keeping-up/chapter.adoc +why-port/_index.adoc +own-port/_index.adoc +quick-porting/_index.adoc +slow/_index.adoc +makefile/_index.adoc +special/_index.adoc +plist/_index.adoc +pkg-files/_index.adoc +testing/_index.adoc +port-upgrading/_index.adoc +security/_index.adoc +porting-dads/_index.adoc +porting-samplem/_index.adoc +keeping-up/_index.adoc diff --git a/documentation/content/zh-cn/books/porters-handbook/keeping-up/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/keeping-up/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/porters-handbook/keeping-up/chapter.adoc rename to documentation/content/zh-cn/books/porters-handbook/keeping-up/_index.adoc diff --git a/documentation/content/zh-cn/books/porters-handbook/makefile/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/makefile/_index.adoc similarity index 98% rename from documentation/content/zh-cn/books/porters-handbook/makefile/chapter.adoc rename to documentation/content/zh-cn/books/porters-handbook/makefile/_index.adoc index 58ab9de20b..1343c993df 100644 --- a/documentation/content/zh-cn/books/porters-handbook/makefile/chapter.adoc +++ b/documentation/content/zh-cn/books/porters-handbook/makefile/_index.adoc @@ -1155,7 +1155,7 @@ PATCHFILES= patch1:test ** `fetch-list`： 和旧式的 `fetch-list` 类似， 但以同 `do-fetch` 相似的方式处理组。 ** `master-sites` 和 `patch-sites`： (与旧版本不兼容) 仅返回组 `DEFAULT` 的元素； 事实上， 它们会执行 `master-sites-default` 和 `patch-sites-default` 这两个 target。 + -更进一步， 使用 `master-sites-all` 或 `patch-sites-all` 这两个 target 之一， 要比直接检查 `MASTER_SITES` 或 `PATCH_SITES` 更好。 此外， 未来版本可能不再保证直接检查能够正确工作。 请参见 <> 以了解关于这些新 target 的更多技术细节。 +更进一步， 使用 `master-sites-all` 或 `patch-sites-all` 这两个 target 之一， 要比直接检查 `MASTER_SITES` 或 `PATCH_SITES` 更好。 此外， 未来版本可能不再保证直接检查能够正确工作。 请参见 <> 以了解关于这些新 target 的更多技术细节。 . port 中的新 target .. 一系列 `master-sites-_n_` 和 `patch-sites-_n_` target 可以分别用来列出 `MASTER_SITES` 和 `PATCH_SITES` 中的 _n_ 组的内容。 例如， `master-sites-DEFAULT` 和 `patch-sites-DEFAULT` 都会返回 `DEFAULT` 组的内容， 而 `master-sites-test` 和 `patch-sites-test` 则返回 `test` 组的内容， 等等。 @@ -1390,7 +1390,7 @@ USE_GCC=3.4 |此 port 需要使用某一特定版本的 `gcc` 才能完成编译。 可以使用类似 `3.4` 这样的值来精确指定版本。 如果希望使用不低于某一版本的编译器， 则可以用 `3.4+` 这样的形式。 如果与所希望的版本吻合， 则将使用基本系统中所提供的 `gcc`， 反之， 系统会从 ports 中安装所希望版本的 `gcc`， 并调整 `CC` 以及 `CXX` 变量的设置。 |=== -与 gmake 和 [.filename]#configure# 脚本有关的变量在 <> 中进行了介绍， 而 autoconf、 automake 以及 libtool 的介绍则可以在 <> 找到。 <> 介绍了与 Perl 有关的的变量。 <> 中列出了关于 X11 的变量。 关于 GNOME 的变量在 <>， 而关于 KDE 的则在 <>。 <> 讲述了和 Java 有关的变量， 而 <> 则包含了关于 Apache、 PHP 以及 PEAR 的介绍性信息。 关于 Python， 在 <> 进行了讨论， 而关于 Ruby 的介绍， 则可以在 <> 中找到。 <> 提供了用于 SDL 应用程序的变量介绍， 最后， <> 包含了关于 Xfce 的信息。 +与 gmake 和 [.filename]#configure# 脚本有关的变量在 crossref:special[building, 联编机制] 中进行了介绍， 而 autoconf、 automake 以及 libtool 的介绍则可以在 crossref:special[using-autotools, 利用 GNU autotools] 找到。 crossref:special[using-perl, 使用 perl] 介绍了与 Perl 有关的的变量。 crossref:special[using-x11, 使用 X11] 中列出了关于 X11 的变量。 关于 GNOME 的变量在 crossref:special[using-gnome, 使用 GNOME]， 而关于 KDE 的则在 crossref:special[using-kde, 使用 KDE]。 crossref:special[using-java, 使用 Java] 讲述了和 Java 有关的变量， 而 crossref:special[using-php, "Web 应用， Apache 和 PHP"] 则包含了关于 Apache、 PHP 以及 PEAR 的介绍性信息。 关于 Python， 在 crossref:special[using-python, 使用 Python] 进行了讨论， 而关于 Ruby 的介绍， 则可以在 crossref:special[using-ruby, 使用 Ruby] 中找到。 crossref:special[using-sdl, 使用 SDL] 提供了用 SDL 应用程序的变量介绍， 最后， crossref:special[using-xfce, 使用 Xfce] 包含了关于 Xfce 的信息。 === 在依赖关系中指定最低版本 @@ -1743,7 +1743,7 @@ NO_WRKSUBDIR= yes [NOTE] ==== -这些用于描述冲突的变量会自动地设置 `IGNORE`， 后者的完整介绍， 可以在 <> 找到。 +这些用于描述冲突的变量会自动地设置 `IGNORE`， 后者的完整介绍， 可以在 crossref:porting-dads[dads-noinstall, 使用 `BROKEN`、 `FORBIDDEN` 或 `IGNORE` 阻止用户安装 port] 找到。 ==== 在删去相互冲突的 port 时， 建议将 `CONFLICTS` 保留几个月， 以便让那些不经常更新系统的用户能够看到。 diff --git a/documentation/content/zh-cn/books/porters-handbook/own-port/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/own-port/_index.adoc similarity index 96% rename from documentation/content/zh-cn/books/porters-handbook/own-port/chapter.adoc rename to documentation/content/zh-cn/books/porters-handbook/own-port/_index.adoc index b1441238d9..3969d2b6b4 100644 --- a/documentation/content/zh-cn/books/porters-handbook/own-port/chapter.adoc +++ b/documentation/content/zh-cn/books/porters-handbook/own-port/_index.adoc @@ -44,7 +44,7 @@ endif::[] 那么， 您有兴趣创建自己的 port 或升级现有的 port？ 太好了。 -下面的内容将会提供一些创建FreeBSD port的指导。 如果想升级一个现有的 port， 那么您应该在看完这些内容并阅读 <>。 +下面的内容将会提供一些创建FreeBSD port的指导。 如果想升级一个现有的 port， 那么您应该在看完这些内容并阅读 crossref:port-upgrading[port-upgrading,升级一个 port]。 因为这份文档不是十分详细， 您还应该再参考一下 [.filename]#/usr/ports/Mk/bsd.port.mk#， 所有 port 的 Makefile 文件都会包含它。 即使不是每天都去摆弄 Makefile， 您也会从那个文件里面获得很多知识， 里面的注释非常详细。 还有要补充一下，如果您有其它的问题， 可以给link:{freebsd-ports} 这个 mailing list 发信。 diff --git a/documentation/content/zh-cn/books/porters-handbook/pkg-files/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/pkg-files/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/porters-handbook/pkg-files/chapter.adoc rename to documentation/content/zh-cn/books/porters-handbook/pkg-files/_index.adoc diff --git a/documentation/content/zh-cn/books/porters-handbook/plist/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/plist/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/porters-handbook/plist/chapter.adoc rename to documentation/content/zh-cn/books/porters-handbook/plist/_index.adoc diff --git a/documentation/content/zh-cn/books/porters-handbook/port-upgrading/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/port-upgrading/_index.adoc similarity index 97% rename from documentation/content/zh-cn/books/porters-handbook/port-upgrading/chapter.adoc rename to documentation/content/zh-cn/books/porters-handbook/port-upgrading/_index.adoc index f09dd7e97b..a086a272c2 100644 --- a/documentation/content/zh-cn/books/porters-handbook/port-upgrading/chapter.adoc +++ b/documentation/content/zh-cn/books/porters-handbook/port-upgrading/_index.adoc @@ -79,7 +79,7 @@ endif::[] 再次强调， 请使用 man:diff[1] 而非 man:shar[1] 来发送现有 port 的更新！ 这可以帮助 ports committer 理解需要修改的内容。 ==== -现在您已经了解了所需的所有操作， 您可能会像要阅读在 <> 中关于如何保持最新的描述。 +现在您已经了解了所需的所有操作， 您可能会像要阅读在 crossref:keeping-up[keeping-up, 保持同步] 中关于如何保持最新的描述。 [[cvs-diff]] == 使用 CVS 制作补丁 @@ -107,7 +107,7 @@ endif::[] % cvs remove deleted_file .... -请反复检查 <> 列出的事项并使用 <> 进行检查。 +请反复检查 crossref:quick-porting[porting-testing, 测试 port] 列出的事项并使用 crossref:quick-porting[porting-portlint, 用 portlint 来检查 port] 进行检查。 [source,shell] .... diff --git a/documentation/content/zh-cn/books/porters-handbook/porting-dads/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/porting-dads/_index.adoc similarity index 99% rename from documentation/content/zh-cn/books/porters-handbook/porting-dads/chapter.adoc rename to documentation/content/zh-cn/books/porters-handbook/porting-dads/_index.adoc index b9e8cb4124..c601f5bab4 100644 --- a/documentation/content/zh-cn/books/porters-handbook/porting-dads/chapter.adoc +++ b/documentation/content/zh-cn/books/porters-handbook/porting-dads/_index.adoc @@ -2726,7 +2726,7 @@ IGNORE= is unsupported on FreeBSD 5.x 在 [.filename]#Makefile# 中给出信号， 表示由于某种外界因素 (例如， 用户指定了无效的联编选项) 而无法安装的方法是将变量 `IGNORE` 设为一非空值。 这个值将被格式化， 并在用户执行 `make install` 是给出提示。 -用 `.error` 实现这一目的是一种常见的误用。 这样做的问题是， 许多在 ports 树上运行的自动化工具会因此而失败。 最常见的情况见于联编 [.filename]#/usr/ports/INDEX# 的过程 (参见 <>)。 然而， 即使十分普通的命令， 例如 `make maintainer`， 在这种情况下也会失败。 这是不可接受的。 +用 `.error` 实现这一目的是一种常见的误用。 这样做的问题是， 许多在 ports 树上运行的自动化工具会因此而失败。 最常见的情况见于联编 [.filename]#/usr/ports/INDEX# 的过程 (参见 crossref:testing[make-describe, 运行 make describe])。 然而， 即使十分普通的命令， 例如 `make maintainer`， 在这种情况下也会失败。 这是不可接受的。 [[dot-error-breaks-index]] .怎样避免使用 `.error` diff --git a/documentation/content/zh-cn/books/porters-handbook/porting-samplem/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/porting-samplem/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/porters-handbook/porting-samplem/chapter.adoc rename to documentation/content/zh-cn/books/porters-handbook/porting-samplem/_index.adoc diff --git a/documentation/content/zh-cn/books/porters-handbook/quick-porting/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/quick-porting/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/porters-handbook/quick-porting/chapter.adoc rename to documentation/content/zh-cn/books/porters-handbook/quick-porting/_index.adoc diff --git a/documentation/content/zh-cn/books/porters-handbook/security/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/security/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/porters-handbook/security/chapter.adoc rename to documentation/content/zh-cn/books/porters-handbook/security/_index.adoc diff --git a/documentation/content/zh-cn/books/porters-handbook/slow/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/slow/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/porters-handbook/slow/chapter.adoc rename to documentation/content/zh-cn/books/porters-handbook/slow/_index.adoc diff --git a/documentation/content/zh-cn/books/porters-handbook/special/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/special/_index.adoc similarity index 98% rename from documentation/content/zh-cn/books/porters-handbook/special/chapter.adoc rename to documentation/content/zh-cn/books/porters-handbook/special/_index.adoc index fce05bfac8..e6e20d694d 100644 --- a/documentation/content/zh-cn/books/porters-handbook/special/chapter.adoc +++ b/documentation/content/zh-cn/books/porters-handbook/special/_index.adoc @@ -365,7 +365,7 @@ PLIST_SUB+= NLS="@comment " .endif .... -您要做的下一件事是合理地安排装箱单文件， 使其根据用户配置来决定是否将消息编录 (message catalog) 文件放入最终的装箱单。 前面已经介绍了在 [.filename]#Makefile# 中所需的写法， 这种做法在 <> 这节中进行了介绍。 简单地说， 在 [.filename]#pkg-plist# 中出现的 ``%%NLS%%`` 均会在禁用 NLS 时自动替换为 "``@comment ``"， 反之则替换为空串。 这样， 在最终的装箱单中带 ``%%NLS%%`` 的行， 在 NLS 关闭的情况下就会变为注释， 反之， 这些前缀就会自动删掉。 现在需要做的事情就是把 ``%%NLS%%`` 插到 [.filename]#pkg-plist# 中的消息编录文件的那些行开头， 例如： +您要做的下一件事是合理地安排装箱单文件， 使其根据用户配置来决定是否将消息编录 (message catalog) 文件放入最终的装箱单。 前面已经介绍了在 [.filename]#Makefile# 中所需的写法， 这种做法在 crossref:plist[plist-sub,高级 [.filename]#pkg-plist# 用法] 这节中进行了介绍。 简单地说， 在 [.filename]#pkg-plist# 中出现的 ``%%NLS%%`` 均会在禁用 NLS 时自动替换为 "``@comment ``"， 反之则替换为空串。 这样， 在最终的装箱单中带 ``%%NLS%%`` 的行， 在 NLS 关闭的情况下就会变为注释， 反之， 这些前缀就会自动删掉。 现在需要做的事情就是把 ``%%NLS%%`` 插到 [.filename]#pkg-plist# 中的消息编录文件的那些行开头， 例如： [.programlisting] .... @@ -373,7 +373,7 @@ PLIST_SUB+= NLS="@comment " %%NLS%%share/locale/no/LC_MESSAGES/foobar.mo .... -在比较复杂的情形中， 您可能需要使用更高级的技术， 例如 <> 等。 +在比较复杂的情形中， 您可能需要使用更高级的技术， 例如 crossref:plist[plist-dynamic,动态生成装箱单] 等。 === 处理消息编录目录 @@ -970,7 +970,7 @@ QT_COMPONENTS= qmake_build moc_build rcc_build uic_build |其它 port 安装的 JAR 文件所在的目录。 默认值： [.filename]#${LOCALBASE}/shared/java/classes#。 |=== -相关的项也会定义在 `PLIST_SUB` (在 <> 中进行介绍) 和 `SUB_LIST` 中。 +相关的项也会定义在 `PLIST_SUB` (在 crossref:plist[plist-sub, 根据 `make` 变量对 pkg-plist 进行修改] 中进行介绍) 和 `SUB_LIST` 中。 [[java-building-with-ant]] === 采用 Ant 进行联编 @@ -991,7 +991,7 @@ PLIST_FILES+= %%JAVAJARDIR%%/myport.jar 无论您正制作哪一类的 port (库或者应用程序)， 附加的文档都应安装到和其它 port <>。 已经知道， JavaDoc 会根据 JDK 版本的不同而产生不同的文件。 对于那些不打算强制使用某一特定版本 JDK 的 port 而言， 这无疑提高了制作装箱单 ([.filename]#pkg-plist#) 的难度。 这是为什么强烈建议使用 `PORTDOCS` 宏的原因。 更进一步， 即使您能够预测 `javadoc` 将要生成的文件， 所需的 [.filename]#pkg-plist# 的尺寸， 也是鼓吹使用 `PORTDOCS` 的一大理由。 -`DATADIR` 的默认值是 [.filename]#${PREFIX}/shared/${PORTNAME}#。 对 Java port 而言将 `DATADIR` 改为 [.filename]#${JAVASHAREDIR}/${PORTNAME}# 是一个好主意。 当然， `DATADIR` 会自动加到 `PLIST_SUB` 中 (在 <> 有所介绍) 因此您可以在 [.filename]#pkg-plist# 中直接使用 `%%DATADIR%%`。 +`DATADIR` 的默认值是 [.filename]#${PREFIX}/shared/${PORTNAME}#。 对 Java port 而言将 `DATADIR` 改为 [.filename]#${JAVASHAREDIR}/${PORTNAME}# 是一个好主意。 当然， `DATADIR` 会自动加到 `PLIST_SUB` 中 (在 crossref:plist[plist-sub, 根据 `make` 变量对 pkg-plist 进行修改] 有所介绍) 因此您可以在 [.filename]#pkg-plist# 中直接使用 `%%DATADIR%%`。 撰写本文时， 对是应该从源代码联编， 还是直接安装预编译的 Java ports 安装包并没有明确的规定。 尽管如此， http://www.freebsd.org/java/[FreeBSD Java Project] 的开发人员仍鼓励移植软件的开发者在不麻烦的情况下尽可能从源代码完成联编。 @@ -999,7 +999,7 @@ PLIST_FILES+= %%JAVAJARDIR%%/myport.jar 在 PR 中的 `java` 类别， 主要是用于 FreeBSD Java project 移植 JDK 本身之用。 因而， 提交您的 Java port 时， 应归入 `ports` 类别， 除非您正尝试解决的问题是 JDK 实现本身或 [.filename]#bsd.java.mk# 的。 -类似地， 您应参考 <> 中所详述的关于 `CATEGORIES` 在 Java port 中的使用规则。 +类似地， 您应参考 crossref:makefile[makefile-categories, 分类] 中所详述的关于 `CATEGORIES` 在 Java port 中的使用规则。 [[using-php]] == Web 应用， Apache 和 PHP diff --git a/documentation/content/zh-cn/books/porters-handbook/testing/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/testing/_index.adoc similarity index 98% rename from documentation/content/zh-cn/books/porters-handbook/testing/chapter.adoc rename to documentation/content/zh-cn/books/porters-handbook/testing/_index.adoc index 85582be66d..be42694f12 100644 --- a/documentation/content/zh-cn/books/porters-handbook/testing/chapter.adoc +++ b/documentation/content/zh-cn/books/porters-handbook/testing/_index.adoc @@ -49,7 +49,7 @@ endif::[] [NOTE] ==== -无论在 [.filename]#make.conf# 中设置了什么选项， 这个文件都应能够正确地生成。 因此， 应避免在 (例如) 某个依赖关系无法满足时使用 `.error`。 (参见 <>。) +无论在 [.filename]#make.conf# 中设置了什么选项， 这个文件都应能够正确地生成。 因此， 应避免在 (例如) 某个依赖关系无法满足时使用 `.error`。 (参见 crossref:porting-dads[dads-dot-error, 避免使用 .error 结构]。) ==== 如果 `make describe` 只是产生一个字符串， 而不是错误信息， 可能就没什么问题。 请参见 [.filename]#bsd.port.mk# 以了解所生成的串的意义。 diff --git a/documentation/content/zh-cn/books/porters-handbook/why-port/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/why-port/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/porters-handbook/why-port/chapter.adoc rename to documentation/content/zh-cn/books/porters-handbook/why-port/_index.adoc From nobody Sat Nov 27 19:07:39 2021 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 EF93218C7E73 for ; Sat, 27 Nov 2021 19:07:39 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4J1h2M4BFLz4nh7; Sat, 27 Nov 2021 19:07:39 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 6F91620FEF; Sat, 27 Nov 2021 19:07:39 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1ARJ7dVg096033; Sat, 27 Nov 2021 19:07:39 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1ARJ7dV0096032; Sat, 27 Nov 2021 19:07:39 GMT (envelope-from git) Date: Sat, 27 Nov 2021 19:07:39 GMT Message-Id: <202111271907.1ARJ7dV0096032@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: f80baa00f6 - main - Split Traditional Chinese porter's handbook 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: f80baa00f69a34e7329040f03657389ccbd76763 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1638040059; 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; bh=7NplWZOmkiCIo0MABCc8QxhNOz6xHG3dE7cMXC6RFO4=; b=WsMeCDVFzWfPfhRtCJFn+MxHvS98l3zVNwlECCiQt1fp5yEmpVIK9NVG7MOjfSKXkdi+GA htb0orW7EQq5QAYVSDC7I8hJr9GDm+aMWAUkVFrNYxQE5LJIbeMDYjwMSLfTxl4CeieH4o ggw4UFXmPXkUudb3gN7Q/Fk6Y9Gm1E+QX8cF6KTQlclHP+5GEyHor3AZyI7Lyl/umKJYBm AUhScRbPaLIgmKtioB+cP78lMfkIDPXgjy+lobDECFJGkuedpR40vg5F51X1PQmLkWh+OO Xuuv0WggAAyjq90N+ol9anwpYtQ6nglj6+DWSDJmAZQvlYRmp6647Psl+pL0DA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1638040059; a=rsa-sha256; cv=none; b=jGxdLnLZqNJTDP5QJu5ospUnPxa7NMJFLRULXeEsPiuc6YFi1/2SefUy3wqo7gBcXeY4ap NWzL/33Y0e67zgwyQl+eC0iya3RSwKk69PYBdEzbXMSDwZXHlwxXvnWXGHYydDLvGdKub0 UYPgUeOjIYy8Hy48hPB9ZlAB79MfJRCGdWUZrrtp8C+oXNIcAg8am6Yp0ECnlB4C3TMLf9 Lka83BXOQj1QW4aufXmak7YDXbQ0KjCCXbdohzJdjH8ycrSYZ8JTxk5NRjmBsFIN8NgfS8 7XQ2HtdLIfvUE8hrptRKDR+l6MDiO2UZS5BKYHNX8pv84PIsV72J07gHC1Q22A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=f80baa00f69a34e7329040f03657389ccbd76763 commit f80baa00f69a34e7329040f03657389ccbd76763 Author: Sergio Carlavilla Delgado AuthorDate: 2021-11-27 19:07:11 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-11-27 19:07:11 +0000 Split Traditional Chinese porter's handbook --- .../zh-tw/books/porters-handbook/_index.adoc | 28 +- .../content/zh-tw/books/porters-handbook/book.adoc | 70 ++ .../books/porters-handbook/chapters-order.adoc | 36 +- .../flavors/{chapter.adoc => _index.adoc} | 132 ++- .../books/porters-handbook/keeping-up/_index.adoc | 129 +++ .../books/porters-handbook/keeping-up/chapter.adoc | 93 -- .../makefiles/{chapter.adoc => _index.adoc} | 1066 ++++++++++++++------ .../new-port/{chapter.adoc => _index.adoc} | 2 +- .../zh-tw/books/porters-handbook/order/_index.adoc | 279 +++++ .../books/porters-handbook/order/chapter.adoc | 271 ----- .../pkg-files/{chapter.adoc => _index.adoc} | 82 +- .../plist/{chapter.adoc => _index.adoc} | 208 ++-- .../porting-dads/{chapter.adoc => _index.adoc} | 186 +++- .../porting-samplem/{chapter.adoc => _index.adoc} | 17 +- .../porting-why/{chapter.adoc => _index.adoc} | 0 .../quick-porting/{chapter.adoc => _index.adoc} | 11 +- .../security/{chapter.adoc => _index.adoc} | 92 +- .../slow-porting/{chapter.adoc => _index.adoc} | 11 +- .../special/{chapter.adoc => _index.adoc} | 996 ++++++++++++------ .../books/porters-handbook/testing/_index.adoc | 659 ++++++++++++ .../books/porters-handbook/testing/chapter.adoc | 537 ---------- .../books/porters-handbook/upgrading/_index.adoc | 294 ++++++ .../books/porters-handbook/upgrading/chapter.adoc | 228 ----- .../uses/{chapter.adoc => _index.adoc} | 581 +++++++---- .../versions/{chapter.adoc => _index.adoc} | 630 ++++++++++-- 25 files changed, 4380 insertions(+), 2258 deletions(-) diff --git a/documentation/content/zh-tw/books/porters-handbook/_index.adoc b/documentation/content/zh-tw/books/porters-handbook/_index.adoc index 9a78c5fe23..d15a9897e4 100644 --- a/documentation/content/zh-tw/books/porters-handbook/_index.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/_index.adoc @@ -4,21 +4,22 @@ authors: - author: The FreeBSD Documentation Project copyright: 2000-2020 The FreeBSD Documentation Project trademarks: ["freebsd", "sun", "unix", "general"] +next: books/porters-handbook/porting-why +add_single_page_link: true isIndex: true --- = FreeBSD Porter 手冊 :doctype: book :toc: macro -:toclevels: 2 +:toclevels: 1 :icons: font :sectnums: :sectnumlevels: 6 :partnums: :source-highlighter: rouge :experimental: -:book: true -:pdf: false +:images-path: books/porters-handbook/ ifdef::env-beastie[] ifdef::backend-html5[] @@ -44,27 +45,8 @@ endif::[] ''' -toc::[] +include::{chapters-path}toc.adoc[] include::{chapters-path}toc-tables.adoc[] include::{chapters-path}toc-examples.adoc[] - -include::{chapters-path}porting-why/chapter.adoc[leveloffset=+1] -include::{chapters-path}new-port/chapter.adoc[leveloffset=+1] -include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1] -include::{chapters-path}slow-porting/chapter.adoc[leveloffset=+1] -include::{chapters-path}makefiles/chapter.adoc[leveloffset=+1] -include::{chapters-path}special/chapter.adoc[leveloffset=+1] -include::{chapters-path}flavors/chapter.adoc[leveloffset=+1] -include::{chapters-path}plist/chapter.adoc[leveloffset=+1] -include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1] -include::{chapters-path}testing/chapter.adoc[leveloffset=+1] -include::{chapters-path}upgrading/chapter.adoc[leveloffset=+1] -include::{chapters-path}security/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1] -include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1] -include::{chapters-path}order/chapter.adoc[leveloffset=+1] -include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1] -include::{chapters-path}uses/chapter.adoc[leveloffset=+1] -include::{chapters-path}versions/chapter.adoc[leveloffset=+1] diff --git a/documentation/content/zh-tw/books/porters-handbook/book.adoc b/documentation/content/zh-tw/books/porters-handbook/book.adoc new file mode 100644 index 0000000000..c7af3b198e --- /dev/null +++ b/documentation/content/zh-tw/books/porters-handbook/book.adoc @@ -0,0 +1,70 @@ +--- +title: FreeBSD Porter 手冊 +authors: + - author: The FreeBSD Documentation Project +copyright: 2000-2020 The FreeBSD Documentation Project +trademarks: ["freebsd", "sun", "unix", "general"] +add_split_page_link: true +--- + += FreeBSD Porter 手冊 +:doctype: book +:toc: macro +:toclevels: 2 +:icons: font +:sectnums: +:sectnumlevels: 6 +:partnums: +:source-highlighter: rouge +:experimental: +:book: true +:pdf: false + +ifdef::env-beastie[] +ifdef::backend-html5[] +include::shared/authors.adoc[] +include::shared/mirrors.adoc[] +include::shared/releases.adoc[] +include::shared/attributes/attributes-{{% lang %}}.adoc[] +include::shared/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/urls.adoc[] +:chapters-path: content/{{% lang %}}/books/porters-handbook/ +endif::[] +ifdef::backend-pdf,backend-epub3[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] +endif::[] + +ifndef::env-beastie[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] + +''' + +toc::[] + +include::{chapters-path}toc-tables.adoc[] + +include::{chapters-path}toc-examples.adoc[] + +include::{chapters-path}porting-why/_index.adoc[leveloffset=+1] +include::{chapters-path}new-port/_index.adoc[leveloffset=+1] +include::{chapters-path}quick-porting/_index.adoc[leveloffset=+1] +include::{chapters-path}slow-porting/_index.adoc[leveloffset=+1] +include::{chapters-path}makefiles/_index.adoc[leveloffset=+1] +include::{chapters-path}special/_index.adoc[leveloffset=+1] +include::{chapters-path}flavors/_index.adoc[leveloffset=+1] +include::{chapters-path}plist/_index.adoc[leveloffset=+1] +include::{chapters-path}pkg-files/_index.adoc[leveloffset=+1] +include::{chapters-path}testing/_index.adoc[leveloffset=+1] +include::{chapters-path}upgrading/_index.adoc[leveloffset=+1] +include::{chapters-path}security/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-dads/_index.adoc[leveloffset=+1] +include::{chapters-path}porting-samplem/_index.adoc[leveloffset=+1] +include::{chapters-path}order/_index.adoc[leveloffset=+1] +include::{chapters-path}keeping-up/_index.adoc[leveloffset=+1] +include::{chapters-path}uses/_index.adoc[leveloffset=+1] +include::{chapters-path}versions/_index.adoc[leveloffset=+1] diff --git a/documentation/content/zh-tw/books/porters-handbook/chapters-order.adoc b/documentation/content/zh-tw/books/porters-handbook/chapters-order.adoc index 3aaba51a43..81f5b000cb 100644 --- a/documentation/content/zh-tw/books/porters-handbook/chapters-order.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/chapters-order.adoc @@ -1,18 +1,18 @@ -porting-why/chapter.adoc -new-port/chapter.adoc -quick-porting/chapter.adoc -slow-porting/chapter.adoc -makefiles/chapter.adoc -special/chapter.adoc -flavors/chapter.adoc -plist/chapter.adoc -pkg-files/chapter.adoc -testing/chapter.adoc -upgrading/chapter.adoc -security/chapter.adoc -porting-dads/chapter.adoc -porting-samplem/chapter.adoc -order/chapter.adoc -keeping-up/chapter.adoc -uses/chapter.adoc -versions/chapter.adoc +porting-why/_index.adoc +new-port/_index.adoc +quick-porting/_index.adoc +slow-porting/_index.adoc +makefiles/_index.adoc +special/_index.adoc +flavors/_index.adoc +plist/_index.adoc +pkg-files/_index.adoc +testing/_index.adoc +upgrading/_index.adoc +security/_index.adoc +porting-dads/_index.adoc +porting-samplem/_index.adoc +order/_index.adoc +keeping-up/_index.adoc +uses/_index.adoc +versions/_index.adoc diff --git a/documentation/content/zh-tw/books/porters-handbook/flavors/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/flavors/_index.adoc similarity index 64% rename from documentation/content/zh-tw/books/porters-handbook/flavors/chapter.adoc rename to documentation/content/zh-tw/books/porters-handbook/flavors/_index.adoc index d7fb913a66..06c0a73d82 100644 --- a/documentation/content/zh-tw/books/porters-handbook/flavors/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/flavors/_index.adoc @@ -2,6 +2,8 @@ title: Chapter 7. Flavors prev: books/porters-handbook/special next: books/porters-handbook/plist +description: Flavors are a way to have multiple variations of a port +tags: ["Ports", "Flavors", "introduction", "how-to", "guide"] --- [[flavors]] @@ -45,7 +47,8 @@ endif::[] [[flavors-intro]] == An Introduction to Flavors -Flavors are a way to have multiple variations of a port. The port is built multiple times, with variations. +Flavors are a way to have multiple variations of a port. +The port is built multiple times, with variations. For example, a port can have a normal version with many features and quite a few dependencies, and a light "lite" version with only basic features and minimal dependencies. @@ -54,18 +57,17 @@ Another example could be, a port can have a GTK flavor and a QT flavor, dependin [[flavors-using]] == Using FLAVORS -To declare a port having multiple flavors, add `FLAVORS` to its [.filename]#Makefile#. The first flavor in `FLAVORS` is the default flavor. +To declare a port having multiple flavors, add `FLAVORS` to its [.filename]#Makefile#. +The first flavor in `FLAVORS` is the default flavor. [TIP] ==== - It can help simplify the logic of the [.filename]#Makefile# to also define `FLAVOR` as: [.programlisting] .... FLAVOR?= ${FLAVORS:[1]} .... - ==== [IMPORTANT] @@ -77,7 +79,6 @@ To distinguish flavors from options, which are always uppercase letters, flavor .Basic Flavors Usage [example] ==== - If a port has a "lite" slave port, the slave port can be removed, and the port can be converted to flavors with: [.programlisting] @@ -90,18 +91,12 @@ lite_PKGNAMESUFFIX= -lite .endif .... -[NOTE] -**** -The first flavor is the default one, and is called, here, `default`. It is not an obligation, and if possible, use a more specific flavor name, like in <>. -**** - ==== [[flavors-using-ex2]] .Another Basic Flavors Usage [example] ==== - If a port has a `-nox11` slave port, the slave port can be removed, and the port can be converted to flavors with: [.programlisting] @@ -121,48 +116,42 @@ nox11_PKGNAMESUFFIX= -nox11 .More Complex Flavors Usage [example] ==== - -Here is a slightly edited excerpt of what is present in package:devel/libpeas[], a port that uses the <>. With the default Python 2 and 3 versions being 2.7 and 3.6, it will automatically get `FLAVORS=py27 py36` +Here is a slightly edited excerpt of what is present in package:devel/libpeas[], a port that uses the <>. +With the default Python 2 and 3 versions being 2.7 and 3.6, it will automatically get `FLAVORS=py27 py36` [.programlisting] .... USES= gnome python -USE_PYTHON= flavors <.> +USE_PYTHON= flavors -.if ${FLAVOR:Upy27:Mpy2*} <.> -USE_GNOME= pygobject3 <.> +.if ${FLAVOR:Upy27:Mpy2*} +USE_GNOME= pygobject3 CONFIGURE_ARGS+= --enable-python2 --disable-python3 -BUILD_WRKSRC= ${WRKSRC}/loaders/python <.> -INSTALL_WRKSRC= ${WRKSRC}/loaders/python <.> +BUILD_WRKSRC= ${WRKSRC}/loaders/python +INSTALL_WRKSRC= ${WRKSRC}/loaders/python .else # py3* -USE_GNOME+= py3gobject3 <.> +USE_GNOME+= py3gobject3 CONFIGURE_ARGS+= --disable-python2 --enable-python3 \ - ac_cv_path_PYTHON3_CONFIG=${LOCALBASE}/bin/python${PYTHON_VER}-config <.> + ac_cv_path_PYTHON3_CONFIG=${LOCALBASE}/bin/python${PYTHON_VER}-config -BUILD_WRKSRC= ${WRKSRC}/loaders/python3 <.> -INSTALL_WRKSRC= ${WRKSRC}/loaders/python3 <.> +BUILD_WRKSRC= ${WRKSRC}/loaders/python3 +INSTALL_WRKSRC= ${WRKSRC}/loaders/python3 .endif -py34_PLIST= ${.CURDIR}/pkg-plist-py3 <.> -py35_PLIST= ${.CURDIR}/pkg-plist-py3 <.> -py36_PLIST= ${.CURDIR}/pkg-plist-py3 <.> +py34_PLIST= ${.CURDIR}/pkg-plist-py3 +py35_PLIST= ${.CURDIR}/pkg-plist-py3 +py36_PLIST= ${.CURDIR}/pkg-plist-py3 .... -<.> This port does not use `USE_PYTHON=distutils` but needs Python flavors anyway. - -<.> To guard against `FLAVOR` being empty, which would cause a man:make[1] error, use `${FLAVOR:U}` in string comparisons instead of `${FLAVOR}`. - -<.> <.> The Gnome Python gobject3 bindings have two different names, one for Python 2, pygobject3 and one for Python 3, py3gobject3. - -<.> The `configure` script has to run in [.filename]#${WRKSRC}#, but we are only interested in building and installing the Python 2 or Python 3 parts of the software, so set the build and install base directories appropriately. - -<.> Hint about the correct Python 3 config script path name. - -<.> The packing list is different when the built with Python 3. As there are three possible Python 3 versions, set `PLIST` for all three using the <>. - +This port does not use `USE_PYTHON=distutils` but needs Python flavors anyway. +To guard against `FLAVOR` being empty, which would cause a man:make[1] error, use `${FLAVOR:U}` in string comparisons instead of `${FLAVOR}`. +The Gnome Python gobject3 bindings have two different names, one for Python 2, pygobject3 and one for Python 3, py3gobject3. +The `configure` script has to run in [.filename]#${WRKSRC}#, but we are only interested in building and installing the Python 2 or Python 3 parts of the software, so set the build and install base directories appropriately. +Hint about the correct Python 3 config script path name. +The packing list is different when the built with Python 3. As there are three possible Python 3 versions, set `PLIST` for all three using the <>. ==== [[flavors-using-helpers]] @@ -172,31 +161,31 @@ To make the [.filename]#Makefile# easier to write, a few flavors helpers exist. This list of helpers will set their variable: -* `flavor_PKGNAMEPREFIX` -* `flavor_PKGNAMESUFFIX` -* `flavor_PLIST` -* `flavor_DESCR` +* `_flavor__PKGNAMEPREFIX` +* `_flavor__PKGNAMESUFFIX` +* `_flavor__PLIST` +* `_flavor__DESCR` This list of helpers will append to their variable: -* `flavor_CONFLICTS` -* `flavor_CONFLICTS_BUILD` -* `flavor_CONFLICTS_INSTALL` -* `flavor_PKG_DEPENDS` -* `flavor_EXTRACT_DEPENDS` -* `flavor_PATCH_DEPENDS` -* `flavor_FETCH_DEPENDS` -* `flavor_BUILD_DEPENDS` -* `flavor_LIB_DEPENDS` -* `flavor_RUN_DEPENDS` -* `flavor_TEST_DEPENDS` +* `_flavor__CONFLICTS` +* `_flavor__CONFLICTS_BUILD` +* `_flavor__CONFLICTS_INSTALL` +* `_flavor__PKG_DEPENDS` +* `_flavor__EXTRACT_DEPENDS` +* `_flavor__PATCH_DEPENDS` +* `_flavor__FETCH_DEPENDS` +* `_flavor__BUILD_DEPENDS` +* `_flavor__LIB_DEPENDS` +* `_flavor__RUN_DEPENDS` +* `_flavor__TEST_DEPENDS` + [[flavors-helpers-ex1]] .Flavor Specific `PKGNAME` [example] ==== - -As all packages must have a different package name, flavors must change theirs, using `flavor_PKGNAMEPREFIX` and `flavor_PKGNAMESUFFIX` makes this easy: +As all packages must have a different package name, flavors must change theirs, using `_flavor__PKGNAMEPREFIX` and `_flavor__PKGNAMESUFFIX` makes this easy: [.programlisting] .... @@ -209,18 +198,13 @@ lite_PKGNAMESUFFIX= -lite [[flavors-auto-php]] == `USES=php` and Flavors -When using <> with one of these arguments, `phpize`, `ext`, `zend`, or `pecl`, the port will automatically have `FLAVORS` filled in with the PHP versions it supports. - -[NOTE] -==== -All the examples assume the currently supported PHP versions are 5.6, 7.0, 7.1, and 7.2. -==== +When using crossref:uses[uses-php,`php`] with one of these arguments, `phpize`, `ext`, `zend`, or `pecl`, +the port will automatically have `FLAVORS` filled in with the PHP versions it supports. [[flavors-auto-php-ex1]] .Simple `USES=php` Extension [example] ==== - This will generate package for all the supported versions: [.programlisting] @@ -262,7 +246,6 @@ PHP applications that are flavorized _must_ append `PHP_PKGNAMESUFFIX` to their .Flavorizing a PHP Application [example] ==== - Adding Flavors support to a PHP application is straightforward: [.programlisting] @@ -276,20 +259,20 @@ USES= php:flavors [TIP] ==== - -When adding a dependency on a PHP flavored port, use `@${PHP_FLAVOR}`. _Never_ use `FLAVOR` directly. +When adding a dependency on a PHP flavored port, use `@${PHP_FLAVOR}`. +_Never_ use `FLAVOR` directly. ==== [[flavors-auto-python]] == `USES=python` and Flavors -When using <> and `USE_PYTHON=distutils`, the port will automatically have `FLAVORS` filled in with the Python versions it supports. +When using crossref:uses[uses-python,`python`] and `USE_PYTHON=distutils`, +the port will automatically have `FLAVORS` filled in with the Python versions it supports. [[flavors-auto-python-ex1]] .Simple `USES=python` [example] ==== - Supposing the current Python supported versions are 2.7, 3.4, 3.5, and 3.6, and the default Python 2 and 3 versions are 2.7 and 3.6, a port with: [.programlisting] @@ -313,7 +296,6 @@ Will get these flavors: `py27`, `py34`, `py35` and `py36`. .`USES=python` with Version Requirements [example] ==== - Supposing the current Python supported versions are 2.7, 3.4, 3.5, and 3.6, and the default Python 2 and 3 versions are 2.7 and 3.6, a port with: [.programlisting] @@ -349,13 +331,13 @@ USE_PYTHON= distutils allflavors Will get these flavors: `py34`, `py35`, and `py36`. ==== -`PY_FLAVOR` is available to depend on the correct version of Python modules. All dependencies on flavored Python ports should use `PY_FLAVOR`, and not `FLAVOR` directly.. +`PY_FLAVOR` is available to depend on the correct version of Python modules. +All dependencies on flavored Python ports should use `PY_FLAVOR`, and not `FLAVOR` directly.. [[flavors-auto-python-ex3]] .For a Port Not Using `distutils` [example] ==== - If the default Python 3 version is 3.6, the following will set `PY_FLAVOR` to `py36`: [.programlisting] @@ -366,3 +348,15 @@ USES= python:3.5+ .... ==== + +[[flavors-auto-lua]] +== `USES=lua` and Flavors + +When using crossref:uses[uses-lua,`lua:module`] or crossref:uses[uses-lua,`lua:flavors`], +the port will automatically have `FLAVORS` filled in with the Lua versions it supports. +However, it is not expected that ordinary applications (rather than Lua modules) should use this feature; +most applications that embed or otherwise use Lua should simply use `USES=lua`. + +`LUA_FLAVOR` is available (and must be used) to depend on the correct version of dependencies regardless of whether the port used the `flavors` or `module` parameters. + +See crossref:special[using-lua,Using Lua] for further information. diff --git a/documentation/content/zh-tw/books/porters-handbook/keeping-up/_index.adoc b/documentation/content/zh-tw/books/porters-handbook/keeping-up/_index.adoc new file mode 100644 index 0000000000..195910b56e --- /dev/null +++ b/documentation/content/zh-tw/books/porters-handbook/keeping-up/_index.adoc @@ -0,0 +1,129 @@ +--- +title: Chapter 16. Keeping Up +prev: books/porters-handbook/order +next: books/porters-handbook/uses +description: How to keep up the FreeBSD Ports Collection +tags: ["keeping up", "ports", "updating", "FreshPorts"] +--- + +[[keeping-up]] += Keeping Up +:doctype: book +:toc: macro +:toclevels: 1 +:icons: font +:sectnums: +:sectnumlevels: 6 +:sectnumoffset: 16 +:partnums: +:source-highlighter: rouge +:experimental: +:images-path: books/porters-handbook/ + +ifdef::env-beastie[] +ifdef::backend-html5[] +:imagesdir: ../../../../images/{images-path} +endif::[] +ifndef::book[] +include::shared/authors.adoc[] +include::shared/mirrors.adoc[] +include::shared/releases.adoc[] +include::shared/attributes/attributes-{{% lang %}}.adoc[] +include::shared/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/urls.adoc[] +toc::[] +endif::[] +ifdef::backend-pdf,backend-epub3[] +include::../../../../../shared/asciidoctor.adoc[] +endif::[] +endif::[] + +ifndef::env-beastie[] +toc::[] +include::../../../../../shared/asciidoctor.adoc[] +endif::[] + +The FreeBSD Ports Collection is constantly changing. +Here is some information on how to keep up. + +[[freshports]] +== FreshPorts + +One of the easiest ways to learn about updates that have already been committed is by subscribing to http://www.FreshPorts.org/[FreshPorts]. +Multiple ports can be monitored. +Maintainers are strongly encouraged to subscribe, because they will receive notification of not only their own changes, but also any changes that any other FreeBSD committer has made. +(These are often necessary to keep up with changes in the underlying ports framework-although it would be most polite to receive an advance heads-up from those committing such changes, sometimes this is overlooked or impractical. +Also, in some cases, the changes are very minor in nature. +We expect everyone to use their best judgement in these cases.) + +To use FreshPorts, an account is required. +Those with registered email addresses at `@FreeBSD.org` will see the opt-in link on the right-hand side of the web pages. +Those who already have a FreshPorts account but are not using a `@FreeBSD.org` email address can change the email to `@FreeBSD.org`, subscribe, then change it back again. + +FreshPorts also has a sanity test feature which automatically tests each commit to the FreeBSD ports tree. +If subscribed to this service, a committer will receive notifications of any errors which FreshPorts detects during sanity testing of their commits. + +[[cgit]] +== The Web Interface to the Source Repository + +It is possible to browse the files in the source repository by using a web interface. +Changes that affect the entire port system are now documented in the https://cgit.freebsd.org/ports/tree/CHANGES[CHANGES] file. +Changes that affect individual ports are now documented in the https://cgit.FreeBSD.org/ports/tree/UPDATING[UPDATING] file. +However, the definitive answer to any question is undoubtedly to read the source code of https://cgit.FreeBSD.org/ports/tree/Mk/bsd.port.mk[bsd.port.mk], and associated files. + +[[ports-mailing-list]] +== The FreeBSD Ports Mailing List + +As a ports maintainer, consider subscribing to {freebsd-ports}. +Important changes to the way ports work will be announced there, and then committed to [.filename]#CHANGES#. + +If the volume of messages on this mailing list is too high, consider following {freebsd-ports-announce} which contains only announcements. + +[[build-cluster]] +== The FreeBSD Port Building Cluster + +One of the least-publicized strengths of FreeBSD is that an entire cluster of machines is dedicated to continually building the Ports Collection, for each of the major OS releases and for each Tier-1 architecture. + +Individual ports are built unless they are specifically marked with `IGNORE`. +Ports that are marked with `BROKEN` will still be attempted, to see if the underlying problem has been resolved. +(This is done by passing `TRYBROKEN` to the port's [.filename]#Makefile#.) + +[[distfile-survey]] +== Portscout: the FreeBSD Ports Distfile Scanner + +The build cluster is dedicated to building the latest release of each port with distfiles that have already been fetched. +However, as the Internet continually changes, distfiles can quickly go missing. +http://portscout.FreeBSD.org[Portscout], the FreeBSD Ports distfile scanner, attempts to query every download site for every port to find out if each distfile is still available. +Portscout can generate HTML reports and send emails about newly available ports to those who request them. +Unless not otherwise subscribed, maintainers are asked to check periodically for changes, either by hand or using the RSS feed. + +Portscout's first page gives the email address of the port maintainer, the number of ports the maintainer is responsible for, the number of those ports with new distfiles, and the percentage of those ports that are out-of-date. +The search function allows for searching by email address for a specific maintainer, and for selecting whether only out-of-date ports are shown. + +Upon clicking on a maintainer's email address, a list of all of their ports is displayed, along with port category, current version number, whether or not there is a new version, when the port was last updated, and finally when it was last checked. +A search function on this page allows the user to search for a specific port. + +Clicking on a port name in the list displays the http://freshports.org[FreshPorts] port information. + +Additional documentation is available in the https://github.com/freebsd/portscout[Portscout repository]. + +[[portsmon]] +== The FreeBSD Ports Monitoring System + +Another handy resource is the http://portsmon.FreeBSD.org[FreeBSD Ports Monitoring System] (also known as `portsmon`). +This system comprises a database that processes information from several sources and allows it to be browsed via a web interface. +Currently, the ports Problem Reports (PRs), the error logs from the build cluster, and individual files from the ports collection are used. +In the future, this will be expanded to include the distfile survey, as well as other sources. + +To get started, use the http://portsmon.FreeBSD.org/portoverview.py[Overview of One Port] search page to find all the information about a port. + +This is the only resource available that maps PR entries to portnames. +PR submitters do not always include the portname in their Synopsis, although we would prefer that they did. +So, `portsmon` is a good place to find out whether an existing port has any PRs filed against it, any build errors, +or if a new port the porter is considering creating has already been submitted. + +[NOTE] +====== +The FreeBSD Ports Monitoring System (portsmon) is currently not working due to latest Python updates. +====== diff --git a/documentation/content/zh-tw/books/porters-handbook/keeping-up/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/keeping-up/chapter.adoc deleted file mode 100644 index d7007ede19..0000000000 --- a/documentation/content/zh-tw/books/porters-handbook/keeping-up/chapter.adoc +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: Chapter 16. Keeping Up -prev: books/porters-handbook/order -next: books/porters-handbook/uses ---- - -[[keeping-up]] -= Keeping Up -:doctype: book -:toc: macro -:toclevels: 1 -:icons: font -:sectnums: -:sectnumlevels: 6 -:sectnumoffset: 16 -:partnums: -:source-highlighter: rouge -:experimental: -:images-path: books/porters-handbook/ - -ifdef::env-beastie[] -ifdef::backend-html5[] -:imagesdir: ../../../../images/{images-path} -endif::[] -ifndef::book[] -include::shared/authors.adoc[] -include::shared/mirrors.adoc[] -include::shared/releases.adoc[] -include::shared/attributes/attributes-{{% lang %}}.adoc[] -include::shared/{{% lang %}}/teams.adoc[] -include::shared/{{% lang %}}/mailing-lists.adoc[] -include::shared/{{% lang %}}/urls.adoc[] -toc::[] -endif::[] -ifdef::backend-pdf,backend-epub3[] -include::../../../../../shared/asciidoctor.adoc[] -endif::[] -endif::[] - -ifndef::env-beastie[] -toc::[] -include::../../../../../shared/asciidoctor.adoc[] -endif::[] - -The FreeBSD Ports Collection is constantly changing. Here is some information on how to keep up. - -[[freshports]] -== FreshPorts - -One of the easiest ways to learn about updates that have already been committed is by subscribing to http://www.FreshPorts.org/[FreshPorts]. Multiple ports can be monitored. Maintainers are strongly encouraged to subscribe, because they will receive notification of not only their own changes, but also any changes that any other FreeBSD committer has made. (These are often necessary to keep up with changes in the underlying ports framework-although it would be most polite to receive an advance heads-up from those committing such changes, sometimes this is overlooked or impractical. Also, in some cases, the changes are very minor in nature. We expect everyone to use their best judgement in these cases.) - -To use FreshPorts, an account is required. Those with registered email addresses at `@FreeBSD.org` will see the opt-in link on the right-hand side of the web pages. Those who already have a FreshPorts account but are not using a `@FreeBSD.org` email address can change the email to `@FreeBSD.org`, subscribe, then change it back again. - -FreshPorts also has a sanity test feature which automatically tests each commit to the FreeBSD ports tree. If subscribed to this service, a committer will receive notifications of any errors which FreshPorts detects during sanity testing of their commits. - -[[svnweb]] -== The Web Interface to the Source Repository - -It is possible to browse the files in the source repository by using a web interface. Changes that affect the entire port system are now documented in the http://svnweb.FreeBSD.org/ports/head/CHANGES[CHANGES] file. Changes that affect individual ports are now documented in the http://svnweb.FreeBSD.org/ports/head/UPDATING[UPDATING] file. However, the definitive answer to any question is undoubtedly to read the source code of http://svnweb.FreeBSD.org/ports/head/Mk/bsd.port.mk[bsd.port.mk], and associated files. - -[[ports-mailing-list]] -== The FreeBSD Ports Mailing List - -As a ports maintainer, consider subscribing to {freebsd-ports}. Important changes to the way ports work will be announced there, and then committed to [.filename]#CHANGES#. - -If the volume of messages on this mailing list is too high, consider following {freebsd-ports-announce} which contains only announcements. - -[[build-cluster]] -== The FreeBSD Port Building Cluster - -One of the least-publicized strengths of FreeBSD is that an entire cluster of machines is dedicated to continually building the Ports Collection, for each of the major OS releases and for each Tier-1 architecture. - -Individual ports are built unless they are specifically marked with `IGNORE`. Ports that are marked with `BROKEN` will still be attempted, to see if the underlying problem has been resolved. (This is done by passing `TRYBROKEN` to the port's [.filename]#Makefile#.) - -[[distfile-survey]] -== Portscout: the FreeBSD Ports Distfile Scanner - -The build cluster is dedicated to building the latest release of each port with distfiles that have already been fetched. However, as the Internet continually changes, distfiles can quickly go missing. http://portscout.FreeBSD.org[Portscout], the FreeBSD Ports distfile scanner, attempts to query every download site for every port to find out if each distfile is still available. Portscout can generate HTML reports and send emails about newly available ports to those who request them. Unless not otherwise subscribed, maintainers are asked to check periodically for changes, either by hand or using the RSS feed. - -Portscout's first page gives the email address of the port maintainer, the number of ports the maintainer is responsible for, the number of those ports with new distfiles, and the percentage of those ports that are out-of-date. The search function allows for searching by email address for a specific maintainer, and for selecting whether only out-of-date ports are shown. - -Upon clicking on a maintainer's email address, a list of all of their ports is displayed, along with port category, current version number, whether or not there is a new version, when the port was last updated, and finally when it was last checked. A search function on this page allows the user to search for a specific port. - -Clicking on a port name in the list displays the http://freshports.org[FreshPorts] port information. - -[[portsmon]] -== The FreeBSD Ports Monitoring System - -Another handy resource is the http://portsmon.FreeBSD.org[FreeBSD Ports Monitoring System] (also known as `portsmon`). This system comprises a database that processes information from several sources and allows it to be browsed via a web interface. Currently, the ports Problem Reports (PRs), the error logs from the build cluster, and individual files from the ports collection are used. In the future, this will be expanded to include the distfile survey, as well as other sources. - -To get started, use the http://portsmon.FreeBSD.org/portoverview.py[Overview of One Port] search page to find all the information about a port. - -This is the only resource available that maps PR entries to portnames. PR submitters do not always include the portname in their Synopsis, although we would prefer that they did. So, `portsmon` is a good place to find out whether an existing port has any PRs filed against it, any build errors, or if a new port the porter is considering creating has already been submitted. diff --git a/documentation/content/zh-tw/books/porters-handbook/makefiles/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/makefiles/_index.adoc similarity index 68% rename from documentation/content/zh-tw/books/porters-handbook/makefiles/chapter.adoc rename to documentation/content/zh-tw/books/porters-handbook/makefiles/_index.adoc index 7e15a3648e..fbc0f6cd7b 100644 --- a/documentation/content/zh-tw/books/porters-handbook/makefiles/chapter.adoc +++ b/documentation/content/zh-tw/books/porters-handbook/makefiles/_index.adoc @@ -2,6 +2,8 @@ title: Chapter 5. Configuring the Makefile prev: books/porters-handbook/slow-porting next: books/porters-handbook/special +description: Configuring the Makefile for FreeBSD Ports +tags: ["makefiles", "configuring", "naming", "versions"] --- [[makefiles]] @@ -43,16 +45,20 @@ toc::[] include::../../../../../shared/asciidoctor.adoc[] endif::[] -Configuring the [.filename]#Makefile# is pretty simple, and again we suggest looking at existing examples before starting. Also, there is a <> in this handbook, so take a look and please follow the ordering of variables and sections in that template to make the port easier for others to read. +Configuring the [.filename]#Makefile# is pretty simple, and again we suggest looking at existing examples before starting. +Also, there is a crossref:porting-samplem[porting-samplem,sample Makefile] in this handbook, +so take a look and please follow the ordering of variables and sections in that template to make the port easier for others to read. Consider these problems in sequence during the design of the new [.filename]#Makefile#: [[makefile-source]] == The Original Source -Does it live in `DISTDIR` as a standard ``gzip``ped tarball named something like [.filename]#foozolix-1.2.tar.gz#? If so, go on to the next step. If not, the distribution file format might require overriding one or more of `DISTVERSION`, `DISTNAME`, `EXTRACT_CMD`, `EXTRACT_BEFORE_ARGS`, `EXTRACT_AFTER_ARGS`, `EXTRACT_SUFX`, or `DISTFILES`. +Does it live in `DISTDIR` as a standard ``gzip``ped tarball named something like [.filename]#foozolix-1.2.tar.gz#? If so, go on to the next step. +If not, the distribution file format might require overriding one or more of `DISTVERSION`, `DISTNAME`, `EXTRACT_CMD`, `EXTRACT_BEFORE_ARGS`, `EXTRACT_AFTER_ARGS`, `EXTRACT_SUFX`, or `DISTFILES`. -In the worst case, create a custom `do-extract` target to override the default. This is rarely, if ever, necessary. +In the worst case, create a custom `do-extract` target to override the default. +This is rarely, if ever, necessary. [[makefile-naming]] == Naming @@ -62,11 +68,14 @@ The first part of the port's [.filename]#Makefile# names the port, describes its [[makefile-portname]] === `PORTNAME` -Set `PORTNAME` to the base name of the software. It is used as the base for the FreeBSD package, and for <>. +Set `PORTNAME` to the base name of the software. +It is used as the base for the FreeBSD package, and for <>. [IMPORTANT] ==== -The package name must be unique across the entire ports tree. Make sure that the `PORTNAME` is not already in use by an existing port, and that no other port already has the same `PKGBASE`. If the name has already been used, add either <>. +The package name must be unique across the entire ports tree. +Make sure that the `PORTNAME` is not already in use by an existing port, and that no other port already has the same `PKGBASE`. +If the name has already been used, add either <>. ==== [[makefile-versions]] @@ -74,7 +83,9 @@ The package name must be unique across the entire ports tree. Make sure that the Set `DISTVERSION` to the version number of the software. -`PORTVERSION` is the version used for the FreeBSD package. It will be automatically derived from `DISTVERSION` to be compatible with FreeBSD's package versioning scheme. If the version contains _letters_, it might be needed to set `PORTVERSION` and not `DISTVERSION`. +`PORTVERSION` is the version used for the FreeBSD package. +It will be automatically derived from `DISTVERSION` to be compatible with FreeBSD's package versioning scheme. +If the version contains _letters_, it might be needed to set `PORTVERSION` and not `DISTVERSION`. [IMPORTANT] ==== @@ -85,12 +96,12 @@ From time to time, some software will use a version scheme that is not compatibl [TIP] ==== - -When updating a port, it is possible to use man:pkg-version[8]'s `-t` argument to check if the new version is greater or lesser than before. See <>. +When updating a port, it is possible to use man:pkg-version[8]'s `-t` argument to check if the new version is greater or lesser than before. +See <>. ==== [[makefile-versions-ex-pkg-version]] -.Using man:pkg-version[8] to Compare Versions. +.Using man:pkg-version[8] to Compare Versions [example] ==== `pkg version -t` takes two versions as arguments, it will respond with `<`, `=` or `>` if the first version is less, equal, or more than the second version, respectively. @@ -120,7 +131,8 @@ When updating a port, it is possible to use man:pkg-version[8]'s `-t` argument t [NOTE] **** -In here, the `a`, `b`, and `p` are used as if meaning "alpha", "beta" or "pre-release" and "patch level", but they are only letters and are sorted alphabetically, so any letter can be used, and they will be sorted appropriately. +In here, the `a`, `b`, and `p` are used as if meaning "alpha", "beta" or "pre-release" and "patch level", +but they are only letters and are sorted alphabetically, so any letter can be used, and they will be sorted appropriately. **** ==== @@ -174,7 +186,8 @@ DISTVERSIONPREFIX= v DISTVERSION= 1_2_4 .... -Some of the time, projects using GitHub will use their name in their versions. For example, the version could be `nekoto-1.2-4`: +Some of the time, projects using GitHub will use their name in their versions. +For example, the version could be `nekoto-1.2-4`: [.programlisting] .... @@ -247,7 +260,8 @@ PORTNAME= nekoto PORTVERSION= 1.2p4 .... -In this case, using `DISTVERSION` is not possible because it would generate a version of `1.2.p4` which would be before `1.2` and not after. man:pkg-version[8] will verify this: +In this case, using `DISTVERSION` is not possible because it would generate a version of `1.2.p4` which would be before `1.2` and not after. +man:pkg-version[8] will verify this: [source,shell] .... @@ -269,9 +283,11 @@ For some more advanced examples of setting `PORTVERSION`, when the software's ve [[makefile-portrevision]] ==== `PORTREVISION` -`PORTREVISION` is a monotonically increasing value which is reset to 0 with every increase of `DISTVERSION`, typically every time there is a new official vendor release. If `PORTREVISION` is non-zero, the value is appended to the package name. Changes to `PORTREVISION` are used by automated tools like man:pkg-version[8] to determine that a new package is available. +`PORTREVISION` is a monotonically increasing value which is reset to 0 with every increase of `DISTVERSION`, typically every time there is a new official vendor release. If `PORTREVISION` is non-zero, the value is appended to the package name. +Changes to `PORTREVISION` are used by automated tools like man:pkg-version[8] to determine that a new package is available. -`PORTREVISION` must be increased each time a change is made to the port that changes the generated package in any way. That includes changes that only affect a package built with non-default <>. +`PORTREVISION` must be increased each time a change is made to the port that changes the generated package in any way. +That includes changes that only affect a package built with non-default <>. Examples of when `PORTREVISION` must be bumped: @@ -288,22 +304,28 @@ Examples of changes which do not require a `PORTREVISION` bump: * Trivial patches to the distfile such as correction of typos, which are not important enough that users of the package have to go to the trouble of upgrading. * Build fixes which cause a package to become compilable where it was previously failing. As long as the changes do not introduce any functional change on any other platforms on which the port did previously build. Since `PORTREVISION` reflects the content of the package, if the package was not previously buildable then there is no need to increase `PORTREVISION` to mark a change. -A rule of thumb is to decide whether a change committed to a port is something which _some_ people would benefit from having. Either because of an enhancement, fix, or by virtue that the new package will actually work at all. Then weigh that against that fact that it will cause everyone who regularly updates their ports tree to be compelled to update. If yes, `PORTREVISION` must be bumped. +A rule of thumb is to decide whether a change committed to a port is something which _some_ people would benefit from having. +Either because of an enhancement, fix, or by virtue that the new package will actually work at all. +Then weigh that against that fact that it will cause everyone who regularly updates their ports tree to be compelled to update. +If yes, `PORTREVISION` must be bumped. [NOTE] ==== -People using binary packages will _never_ see the update if `PORTREVISION` is not bumped. Without increasing `PORTREVISION`, the package builders have no way to detect the change and thus, will not rebuild the package. +People using binary packages will _never_ see the update if `PORTREVISION` is not bumped. +Without increasing `PORTREVISION`, the package builders have no way to detect the change and thus, will not rebuild the package. ==== [[makefile-portepoch]] ==== `PORTEPOCH` -From time to time a software vendor or FreeBSD porter will do something silly and release a version of their software which is actually numerically less than the previous version. An example of this is a port which goes from foo-20000801 to foo-1.0 (the former will be incorrectly treated as a newer version since 20000801 is a numerically greater value than 1). +From time to time a software vendor or FreeBSD porter will do something silly and release a version of their software which is actually numerically less than the previous version. +An example of this is a port which goes from foo-20000801 to foo-1.0 (the former will be incorrectly treated as a newer version since 20000801 is a numerically greater value than 1). [TIP] ==== - -The results of version number comparisons are not always obvious. `pkg version` (see man:pkg-version[8]) can be used to test the comparison of two version number strings. For example: +The results of version number comparisons are not always obvious. +`pkg version` (see man:pkg-version[8]) can be used to test the comparison of two version number strings. +For example: [source,shell] .... @@ -314,13 +336,21 @@ The results of version number comparisons are not always obvious. `pkg version` The `>` output indicates that version 0.031 is considered greater than version 0.29, which may not have been obvious to the porter. ==== -In situations such as this, `PORTEPOCH` must be increased. If `PORTEPOCH` is nonzero it is appended to the package name as described in section 0 above. `PORTEPOCH` must never be decreased or reset to zero, because that would cause comparison to a package from an earlier epoch to fail. For example, the package would not be detected as out of date. The new version number, `1.0,1` in the above example, is still numerically less than the previous version, 20000801, but the `,1` suffix is treated specially by automated tools and found to be greater than the implied suffix `,0` on the earlier package. +In situations such as this, `PORTEPOCH` must be increased. +If `PORTEPOCH` is nonzero it is appended to the package name as described in section 0 above. +`PORTEPOCH` must never be decreased or reset to zero, because that would cause comparison to a package from an earlier epoch to fail. +For example, the package would not be detected as out of date. +The new version number, `1.0,1` in the above example, is still numerically less than the previous version, 20000801, but the `,1` suffix is treated specially by automated tools and found to be greater than the implied suffix `,0` on the earlier package. -Dropping or resetting `PORTEPOCH` incorrectly leads to no end of grief. If the discussion above was not clear enough, please consult the {freebsd-ports}. +Dropping or resetting `PORTEPOCH` incorrectly leads to no end of grief. +If the discussion above was not clear enough, please consult the {freebsd-ports}. -It is expected that `PORTEPOCH` will not be used for the majority of ports, and that sensible use of `DISTVERSION`, or that use `PORTVERSION` carefully, can often preempt it becoming necessary if a future release of the software changes the version structure. However, care is needed by FreeBSD porters when a vendor release is made without an official version number - such as a code "snapshot" release. The temptation is to label the release with the release date, which will cause problems as in the example above when a new "official" release is made. +It is expected that `PORTEPOCH` will not be used for the majority of ports, and that sensible use of `DISTVERSION`, or that use `PORTVERSION` carefully, can often preempt it becoming necessary if a future release of the software changes the version structure. +However, care is needed by FreeBSD porters when a vendor release is made without an official version number - such as a code "snapshot" release. +The temptation is to label the release with the release date, which will cause problems as in the example above when a new "official" release is made. -For example, if a snapshot release is made on the date `20000917`, and the previous version of the software was version `1.2`, do not use `20000917` for `DISTVERSION`. The correct way is a `DISTVERSION` of `1.2.20000917`, or similar, so that the succeeding release, say `1.3`, is still a numerically greater value. +For example, if a snapshot release is made on the date `20000917`, and the previous version of the software was version `1.2`, do not use `20000917` for `DISTVERSION`. +The correct way is a `DISTVERSION` of `1.2.20000917`, or similar, so that the succeeding release, say `1.3`, is still a numerically greater value. [[makefile-portrevision-example]] ==== Example of `PORTREVISION` and `PORTEPOCH` Usage @@ -335,7 +365,8 @@ DISTVERSION= 0.10 `PKGNAME` becomes `gtkmumble-0.10`. -A security hole is discovered which requires a local FreeBSD patch. `PORTREVISION` is bumped accordingly. +A security hole is discovered which requires a local FreeBSD patch. +`PORTREVISION` is bumped accordingly. [.programlisting] .... @@ -346,7 +377,9 @@ PORTREVISION= 1 `PKGNAME` becomes `gtkmumble-0.10_1` -A new version is released by the vendor, numbered `0.2` (it turns out the author actually intended `0.10` to actually mean `0.1.0`, not "what comes after 0.9" - oops, too late now). Since the new minor version `2` is numerically less than the previous version `10`, `PORTEPOCH` must be bumped to manually force the new package to be detected as "newer". Since it is a new vendor release of the code, `PORTREVISION` is reset to 0 (or removed from the [.filename]#Makefile#). +A new version is released by the vendor, numbered `0.2` (it turns out the author actually intended `0.10` to actually mean `0.1.0`, not "what comes after 0.9" - oops, too late now). +Since the new minor version `2` is numerically less than the previous version `10`, `PORTEPOCH` must be bumped to manually force the new package to be detected as "newer". +Since it is a new vendor release of the code, `PORTREVISION` is reset to 0 (or removed from the [.filename]#Makefile#). [.programlisting] .... @@ -357,7 +390,8 @@ PORTEPOCH= 1 `PKGNAME` becomes `gtkmumble-0.2,1` -The next release is 0.3. Since `PORTEPOCH` never decreases, the version variables are now: +The next release is 0.3. +Since `PORTEPOCH` never decreases, the version variables are now: [.programlisting] .... @@ -370,47 +404,69 @@ PORTEPOCH= 1 [NOTE] ==== -If `PORTEPOCH` were reset to `0` with this upgrade, someone who had installed the `gtkmumble-0.10_1` package would not detect the `gtkmumble-0.3` package as newer, since `3` is still numerically less than `10`. Remember, this is the whole point of `PORTEPOCH` in the first place. +If `PORTEPOCH` were reset to `0` with this upgrade, someone who had installed the `gtkmumble-0.10_1` package would not detect the `gtkmumble-0.3` package as newer, since `3` is still numerically less than `10`. +Remember, this is the whole point of `PORTEPOCH` in the first place. ==== [[porting-pkgnameprefix-suffix]] === `PKGNAMEPREFIX` and `PKGNAMESUFFIX` -Two optional variables, `PKGNAMEPREFIX` and `PKGNAMESUFFIX`, are combined with `PORTNAME` and `PORTVERSION` to form `PKGNAME` as `${PKGNAMEPREFIX}${PORTNAME}${PKGNAMESUFFIX}-${PORTVERSION}`. Make sure this conforms to our <>. In particular, the use of a hyphen (`-`) in `PORTVERSION` is _not_ allowed. Also, if the package name has the _language-_ or the _-compiled.specifics_ part (see below), use `PKGNAMEPREFIX` and `PKGNAMESUFFIX`, respectively. Do not make them part of `PORTNAME`. +Two optional variables, `PKGNAMEPREFIX` and `PKGNAMESUFFIX`, are combined with `PORTNAME` and `PORTVERSION` to form `PKGNAME` as `${PKGNAMEPREFIX}${PORTNAME}${PKGNAMESUFFIX}-${PORTVERSION}`. +Make sure this conforms to our <>. +In particular, the use of a hyphen (`-`) in `PORTVERSION` is _not_ allowed. +Also, if the package name has the _language-_ or the _-compiled.specifics_ part (see below), use `PKGNAMEPREFIX` and `PKGNAMESUFFIX`, respectively. +Do not make them part of `PORTNAME`. [[porting-pkgname]] === Package Naming Conventions -These are the conventions to follow when naming packages. This is to make the package directory easy to scan, as there are already thousands of packages and users are going to turn away if they hurt their eyes! +These are the conventions to follow when naming packages. +This is to make the package directory easy to scan, as there are already thousands of packages and users are going to turn away if they hurt their eyes! Package names take the form of [.filename]#language_region-name-compiled.specifics-version.numbers#. -The package name is defined as `${PKGNAMEPREFIX}${PORTNAME}${PKGNAMESUFFIX}-${PORTVERSION}`. Make sure to set the variables to conform to that format. +The package name is defined as `${PKGNAMEPREFIX}${PORTNAME}${PKGNAMESUFFIX}-${PORTVERSION}`. +Make sure to set the variables to conform to that format. [[porting-pkgname-language]] *** 10672 LINES SKIPPED *** From nobody Sat Nov 27 19:29:55 2021 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 526F318AAFE6 for ; Sat, 27 Nov 2021 19:29:56 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4J1hX36Wcpz4tvf; Sat, 27 Nov 2021 19:29:55 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id BBCF221450; Sat, 27 Nov 2021 19:29:55 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1ARJTt5R022272; Sat, 27 Nov 2021 19:29:55 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1ARJTtXS022271; Sat, 27 Nov 2021 19:29:55 GMT (envelope-from git) Date: Sat, 27 Nov 2021 19:29:55 GMT Message-Id: <202111271929.1ARJTtXS022271@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: bcfe49d831 - main - Split Simplified Chinese porter's handbook 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: bcfe49d83196d773e1e61405001a6661ce70e9f4 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1638041395; 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; bh=OkEhzX5yHV1PqaCZbCaFZmocgV7dTDa9dnKnwvUt1pg=; b=wiKI94eVq3pzLLAV3d2zuM9Y+N/QkDbNWkSjQcGpToA5VF3/1jBd3GPOVpCHtbsbfdwPxB mwSjpDcgQAk+L4P2ta9Ta2joktTgmLAybqF26G9O+2/zEhv+7fdKfAzGMVCS9vzvyeQYf9 aujnv9uiT2Qb56/vl1uUocY/8JgIpZFqU6j0fTgLpXy3QxWjhGco3wDF8utTEQaEw9iRP0 zAFSkQizl0dH/brtV85DHsqowiBRf24p7R2I5OUfnSzQbAx/mRdO53ki7WArj8LHTdSxdo T+c9t5teNgt+yEipGs161+xsNJGcPKjzuss6NTrvD6gUDIzdNJHgWGknFFqkyQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1638041395; a=rsa-sha256; cv=none; b=h35QOcoL+kdYJYnfucSRi+65GjysLR/8+FpZ5YwlY9W+t0Zni/KuZbKNGlxhww0sGX7nxg euawxjNPba6uNBP+cfVoPEtRaMkc7FTBi+reywkMfPoujvxQdRh3NRaZxEb8dco2HzHsnJ ar84/jbuuM5levOAujcCAE68dkv9bdt/FcCvc984wHmjuIJMZXiFJsKSV+2nO0z1RFIon1 4jmaMbJroV1auhE6OrXg6gHX6svtr/iFByX/qNi+PetpwCneFGh45tG9thbwED51uHrlqk sy5fLp5IfPF8ZNe9cPbSHHk5ht4pY6sU4Mj8XYO5aPaJAs02ZoKHww8V7NnmHg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=bcfe49d83196d773e1e61405001a6661ce70e9f4 commit bcfe49d83196d773e1e61405001a6661ce70e9f4 Author: Sergio Carlavilla Delgado AuthorDate: 2021-11-27 19:29:26 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-11-27 19:29:26 +0000 Split Simplified Chinese porter's handbook --- .../content/zh-cn/books/arch-handbook/_index.adoc | 38 ++--------- .../bibliography/{chapter.adoc => _index.adoc} | 2 +- .../content/zh-cn/books/arch-handbook/book.adoc | 78 ++++++++++++++++++++++ .../boot/{chapter.adoc => _index.adoc} | 2 +- .../zh-cn/books/arch-handbook/chapters-order.adoc | 37 +++++----- .../driverbasics/{chapter.adoc => _index.adoc} | 2 +- .../isa/{chapter.adoc => _index.adoc} | 0 .../jail/{chapter.adoc => _index.adoc} | 0 .../kobj/{chapter.adoc => _index.adoc} | 0 .../locking/{chapter.adoc => _index.adoc} | 0 .../mac/{chapter.adoc => _index.adoc} | 0 .../newbus/{chapter.adoc => _index.adoc} | 0 .../content/zh-cn/books/arch-handbook/parti.adoc | 18 +++++ .../content/zh-cn/books/arch-handbook/partii.adoc | 18 +++++ .../content/zh-cn/books/arch-handbook/partiii.adoc | 18 +++++ .../pccard/{chapter.adoc => _index.adoc} | 2 +- .../pci/{chapter.adoc => _index.adoc} | 0 .../scsi/{chapter.adoc => _index.adoc} | 0 .../smp/{chapter.adoc => _index.adoc} | 2 +- .../sound/{chapter.adoc => _index.adoc} | 0 .../sysinit/{chapter.adoc => _index.adoc} | 0 .../usb/{chapter.adoc => _index.adoc} | 0 .../arch-handbook/vm/{chapter.adoc => _index.adoc} | 0 23 files changed, 162 insertions(+), 55 deletions(-) diff --git a/documentation/content/zh-cn/books/arch-handbook/_index.adoc b/documentation/content/zh-cn/books/arch-handbook/_index.adoc index 2c20857249..0228d5fd49 100644 --- a/documentation/content/zh-cn/books/arch-handbook/_index.adoc +++ b/documentation/content/zh-cn/books/arch-handbook/_index.adoc @@ -5,21 +5,22 @@ authors: - author: FreeBSD 中文计划 copyright: Copyright © 2000-2006, 2012-2013 The FreeBSD Documentation Project trademarks: ["freebsd", "apple", "microsoft", "unix", "general"] +next: books/arch-handbook/parti +add_single_page_link: true isIndex: true --- = FreeBSD 系统结构手册 :doctype: book :toc: macro -:toclevels: 2 +:toclevels: 1 :icons: font :sectnums: :sectnumlevels: 6 :partnums: :source-highlighter: rouge :experimental: -:book: true -:pdf: false +:images-path: books/arch-handbook/ ifdef::env-beastie[] ifdef::backend-html5[] @@ -52,33 +53,4 @@ endif::[] ''' -toc::[] - -[[kernel]] -= 内核 - -include::{chapters-path}boot/chapter.adoc[leveloffset=+1] -include::{chapters-path}locking/chapter.adoc[leveloffset=+1] -include::{chapters-path}kobj/chapter.adoc[leveloffset=+1] -include::{chapters-path}jail/chapter.adoc[leveloffset=+1] -include::{chapters-path}sysinit/chapter.adoc[leveloffset=+1] -include::{chapters-path}mac/chapter.adoc[leveloffset=+1] -include::{chapters-path}vm/chapter.adoc[leveloffset=+1] -include::{chapters-path}smp/chapter.adoc[leveloffset=+1] - -[[devicedrivers]] -= 设备驱动程序 - -include::{chapters-path}driverbasics/chapter.adoc[leveloffset=+1] -include::{chapters-path}isa/chapter.adoc[leveloffset=+1] -include::{chapters-path}pci/chapter.adoc[leveloffset=+1] -include::{chapters-path}scsi/chapter.adoc[leveloffset=+1] -include::{chapters-path}usb/chapter.adoc[leveloffset=+1] -include::{chapters-path}newbus/chapter.adoc[leveloffset=+1] -include::{chapters-path}sound/chapter.adoc[leveloffset=+1] -include::{chapters-path}pccard/chapter.adoc[leveloffset=+1] - -[[appendices]] -= 附录 - -include::{chapters-path}bibliography/chapter.adoc[leveloffset=+1] +include::{chapters-path}toc.adoc[] diff --git a/documentation/content/zh-cn/books/arch-handbook/bibliography/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/bibliography/_index.adoc similarity index 97% rename from documentation/content/zh-cn/books/arch-handbook/bibliography/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/bibliography/_index.adoc index 53c29d8403..78e23c7a39 100644 --- a/documentation/content/zh-cn/books/arch-handbook/bibliography/chapter.adoc +++ b/documentation/content/zh-cn/books/arch-handbook/bibliography/_index.adoc @@ -1,6 +1,6 @@ --- title: 参考书目 -prev: books/arch-handbook/pccard +prev: books/arch-handbook/partiii --- [bibliography] diff --git a/documentation/content/zh-cn/books/arch-handbook/book.adoc b/documentation/content/zh-cn/books/arch-handbook/book.adoc new file mode 100644 index 0000000000..0eaba06ce3 --- /dev/null +++ b/documentation/content/zh-cn/books/arch-handbook/book.adoc @@ -0,0 +1,78 @@ +--- +title: FreeBSD 系统结构手册 +authors: + - author: The FreeBSD Documentation Project + - author: FreeBSD 中文计划 +copyright: Copyright © 2000-2006, 2012-2013 The FreeBSD Documentation Project +trademarks: ["freebsd", "apple", "microsoft", "unix", "general"] +add_split_page_link: true +--- + += FreeBSD 系统结构手册 +:doctype: book +:toc: macro +:toclevels: 2 +:icons: font +:sectnums: +:sectnumlevels: 6 +:partnums: +:source-highlighter: rouge +:experimental: +:book: true +:pdf: false + +ifdef::env-beastie[] +ifdef::backend-html5[] +include::shared/authors.adoc[] +include::shared/mirrors.adoc[] +include::shared/releases.adoc[] +include::shared/attributes/attributes-{{% lang %}}.adoc[] +include::shared/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/urls.adoc[] +:chapters-path: content/{{% lang %}}/books/arch-handbook/ +endif::[] +ifdef::backend-pdf,backend-epub3[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] +endif::[] + +ifndef::env-beastie[] +:chapters-path: +include::../../../../../shared/asciidoctor.adoc[] +endif::[] + +[.abstract-title] +摘要 + +欢迎您阅读 FreeBSD系统结构手册。 这本手册还在不断由许多人_继续书写_。 许多章节还是空白，有的章节亟待更新。 如果您对这个项目感兴趣并愿意有所贡献，请发信给 {freebsd-doc}。 + +本文档的最新英文原始版本可从 link:https:://www.FreeBSD.org[FreeBSD Web 站点] 获得， 由 link:http://www.FreeBSD.org.cn/[http://www.FreeBSD.org.cn] 维护的最新译本可以在 link:http://cnsnap.cn.FreeBSD.org/zh-cn/[http://www.FreeBSD.org.cn 快照 Web 站点] 和 link:http://cnsnap.cn.FreeBSD.org/doc/zh_CN.UTF-8/[http://www.FreeBSD.org.cn 文档快照] 处获得， 这一译本会不断向主站同步。 此外， 您也可以从 link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[FreeBSD FTP 服务器] 或众多的 extref:{handbook}mirrors/[镜像站点, mirrors-ftp] 得到这份文档的各种其他格式以及压缩形式的版本。 + +''' + +toc::[] + +include::{chapters-path}parti.adoc[lines=15..16] +include::{chapters-path}boot/_index.adoc[leveloffset=+1] +include::{chapters-path}locking/_index.adoc[leveloffset=+1] +include::{chapters-path}kobj/_index.adoc[leveloffset=+1] +include::{chapters-path}jail/_index.adoc[leveloffset=+1] +include::{chapters-path}sysinit/_index.adoc[leveloffset=+1] +include::{chapters-path}mac/_index.adoc[leveloffset=+1] +include::{chapters-path}vm/_index.adoc[leveloffset=+1] +include::{chapters-path}smp/_index.adoc[leveloffset=+1] + +include::{chapters-path}partii.adoc[lines=15..16] +include::{chapters-path}driverbasics/_index.adoc[leveloffset=+1] +include::{chapters-path}isa/_index.adoc[leveloffset=+1] +include::{chapters-path}pci/_index.adoc[leveloffset=+1] +include::{chapters-path}scsi/_index.adoc[leveloffset=+1] +include::{chapters-path}usb/_index.adoc[leveloffset=+1] +include::{chapters-path}newbus/_index.adoc[leveloffset=+1] +include::{chapters-path}sound/_index.adoc[leveloffset=+1] +include::{chapters-path}pccard/_index.adoc[leveloffset=+1] + +include::{chapters-path}partiii.adoc[lines=15..16] +include::{chapters-path}bibliography/_index.adoc[leveloffset=+1] diff --git a/documentation/content/zh-cn/books/arch-handbook/boot/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/boot/_index.adoc similarity index 99% rename from documentation/content/zh-cn/books/arch-handbook/boot/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/boot/_index.adoc index 431ac89f38..faadabd081 100644 --- a/documentation/content/zh-cn/books/arch-handbook/boot/chapter.adoc +++ b/documentation/content/zh-cn/books/arch-handbook/boot/_index.adoc @@ -1,6 +1,6 @@ --- title: 第 1 章 引导过程与内核初始化 -prev: books/arch-handbook/ +prev: books/arch-handbook/parti next: books/arch-handbook/locking --- diff --git a/documentation/content/zh-cn/books/arch-handbook/chapters-order.adoc b/documentation/content/zh-cn/books/arch-handbook/chapters-order.adoc index af38e8536e..ab4d8f3079 100644 --- a/documentation/content/zh-cn/books/arch-handbook/chapters-order.adoc +++ b/documentation/content/zh-cn/books/arch-handbook/chapters-order.adoc @@ -1,17 +1,20 @@ -boot/chapter.adoc -locking/chapter.adoc -kobj/chapter.adoc -jail/chapter.adoc -sysinit/chapter.adoc -mac/chapter.adoc -vm/chapter.adoc -smp/chapter.adoc -driverbasics/chapter.adoc -isa/chapter.adoc -pci/chapter.adoc -scsi/chapter.adoc -usb/chapter.adoc -newbus/chapter.adoc -sound/chapter.adoc -pccard/chapter.adoc -bibliography/chapter.adoc +parti.adoc +boot/_index.adoc +locking/_index.adoc +kobj/_index.adoc +jail/_index.adoc +sysinit/_index.adoc +mac/_index.adoc +vm/_index.adoc +smp/_index.adoc +partii.adoc +driverbasics/_index.adoc +isa/_index.adoc +pci/_index.adoc +scsi/_index.adoc +usb/_index.adoc +newbus/_index.adoc +sound/_index.adoc +pccard/_index.adoc +partiii.adoc +bibliography/_index.adoc diff --git a/documentation/content/zh-cn/books/arch-handbook/driverbasics/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/driverbasics/_index.adoc similarity index 99% rename from documentation/content/zh-cn/books/arch-handbook/driverbasics/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/driverbasics/_index.adoc index 9eeb83eb86..bec7d8bb40 100644 --- a/documentation/content/zh-cn/books/arch-handbook/driverbasics/chapter.adoc +++ b/documentation/content/zh-cn/books/arch-handbook/driverbasics/_index.adoc @@ -1,6 +1,6 @@ --- title: 第 9 章 编写 FreeBSD 设备驱动程序 -prev: books/arch-handbook/smp +prev: books/arch-handbook/partii next: books/arch-handbook/isa --- diff --git a/documentation/content/zh-cn/books/arch-handbook/isa/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/isa/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/arch-handbook/isa/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/isa/_index.adoc diff --git a/documentation/content/zh-cn/books/arch-handbook/jail/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/jail/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/arch-handbook/jail/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/jail/_index.adoc diff --git a/documentation/content/zh-cn/books/arch-handbook/kobj/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/kobj/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/arch-handbook/kobj/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/kobj/_index.adoc diff --git a/documentation/content/zh-cn/books/arch-handbook/locking/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/locking/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/arch-handbook/locking/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/locking/_index.adoc diff --git a/documentation/content/zh-cn/books/arch-handbook/mac/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/mac/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/arch-handbook/mac/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/mac/_index.adoc diff --git a/documentation/content/zh-cn/books/arch-handbook/newbus/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/newbus/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/arch-handbook/newbus/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/newbus/_index.adoc diff --git a/documentation/content/zh-cn/books/arch-handbook/parti.adoc b/documentation/content/zh-cn/books/arch-handbook/parti.adoc new file mode 100644 index 0000000000..c4ade3e3a2 --- /dev/null +++ b/documentation/content/zh-cn/books/arch-handbook/parti.adoc @@ -0,0 +1,18 @@ +--- +title: Part I. 内核 +prev: books/arch-handbook +next: books/arch-handbook/boot +--- + +ifdef::env-beastie+backend-html5[] +:chapters-path: content/{{% lang %}}/books/arch-handbook/ +endif::[] + +ifndef::env-beastie[] +:chapters-path: +endif::[] + +[[kernel]] += 内核 + +include::{chapters-path}toc-1.adoc[] diff --git a/documentation/content/zh-cn/books/arch-handbook/partii.adoc b/documentation/content/zh-cn/books/arch-handbook/partii.adoc new file mode 100644 index 0000000000..cf1d799e46 --- /dev/null +++ b/documentation/content/zh-cn/books/arch-handbook/partii.adoc @@ -0,0 +1,18 @@ +--- +title: Part II. 设备驱动程序 +prev: books/arch-handbook/smp +next: books/arch-handbook/driverbasics +--- + +ifdef::env-beastie+backend-html5[] +:chapters-path: content/{{% lang %}}/books/arch-handbook/ +endif::[] + +ifndef::env-beastie[] +:chapters-path: +endif::[] + +[[devicedrivers]] += 设备驱动程序 + +include::{chapters-path}toc-2.adoc[] diff --git a/documentation/content/zh-cn/books/arch-handbook/partiii.adoc b/documentation/content/zh-cn/books/arch-handbook/partiii.adoc new file mode 100644 index 0000000000..ab4deab9b7 --- /dev/null +++ b/documentation/content/zh-cn/books/arch-handbook/partiii.adoc @@ -0,0 +1,18 @@ +--- +title: Part III. 附录 +prev: books/arch-handbook/pccard +next: books/arch-handbook/bibliography +--- + +ifdef::env-beastie+backend-html5[] +:chapters-path: content/{{% lang %}}/books/arch-handbook/ +endif::[] + +ifndef::env-beastie[] +:chapters-path: +endif::[] + +[[appendices]] += 附录 + +include::{chapters-path}toc-3.adoc[] diff --git a/documentation/content/zh-cn/books/arch-handbook/pccard/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/pccard/_index.adoc similarity index 99% rename from documentation/content/zh-cn/books/arch-handbook/pccard/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/pccard/_index.adoc index 939141d559..459a28f986 100644 --- a/documentation/content/zh-cn/books/arch-handbook/pccard/chapter.adoc +++ b/documentation/content/zh-cn/books/arch-handbook/pccard/_index.adoc @@ -1,7 +1,7 @@ --- title: 第 16 章 PC Card prev: books/arch-handbook/sound -next: books/arch-handbook/bibliography +next: books/arch-handbook/partiii --- [[pccard]] diff --git a/documentation/content/zh-cn/books/arch-handbook/pci/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/pci/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/arch-handbook/pci/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/pci/_index.adoc diff --git a/documentation/content/zh-cn/books/arch-handbook/scsi/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/scsi/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/arch-handbook/scsi/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/scsi/_index.adoc diff --git a/documentation/content/zh-cn/books/arch-handbook/smp/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/smp/_index.adoc similarity index 99% rename from documentation/content/zh-cn/books/arch-handbook/smp/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/smp/_index.adoc index 3fa37c019f..ce8fa9f980 100644 --- a/documentation/content/zh-cn/books/arch-handbook/smp/chapter.adoc +++ b/documentation/content/zh-cn/books/arch-handbook/smp/_index.adoc @@ -1,7 +1,7 @@ --- title: 第 8 章 SMPng 设计文档 prev: books/arch-handbook/vm -next: books/arch-handbook/driverbasics +next: books/arch-handbook/partii --- [[smp]] diff --git a/documentation/content/zh-cn/books/arch-handbook/sound/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/sound/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/arch-handbook/sound/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/sound/_index.adoc diff --git a/documentation/content/zh-cn/books/arch-handbook/sysinit/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/sysinit/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/arch-handbook/sysinit/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/sysinit/_index.adoc diff --git a/documentation/content/zh-cn/books/arch-handbook/usb/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/usb/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/arch-handbook/usb/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/usb/_index.adoc diff --git a/documentation/content/zh-cn/books/arch-handbook/vm/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/vm/_index.adoc similarity index 100% rename from documentation/content/zh-cn/books/arch-handbook/vm/chapter.adoc rename to documentation/content/zh-cn/books/arch-handbook/vm/_index.adoc From nobody Wed Dec 1 15:55:56 2021 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 39CCB18A8E1E for ; Wed, 1 Dec 2021 15:55:57 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4J43bJ6vv2z3jH0; Wed, 1 Dec 2021 15:55:56 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id CD41E4C19; Wed, 1 Dec 2021 15:55:56 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1B1FtuHq019133; Wed, 1 Dec 2021 15:55:56 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1B1FtuDx019132; Wed, 1 Dec 2021 15:55:56 GMT (envelope-from git) Date: Wed, 1 Dec 2021 15:55:56 GMT Message-Id: <202112011555.1B1FtuDx019132@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?Q?Fernando Apestegu=C3=ADa?= Subject: git: 623e4e0dfc - main - [phb][en] Fix c-plus-plus tag 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 623e4e0dfcb0488bb5e07ee817daac167a9181cb Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1638374157; 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; bh=3WfGQzFwiIu8lA0DGGg0vVLAIV23to8akbTg2IKsezM=; b=yqL77DhOcyjJ9S6mJ3Ptqzmj8NQGYTPUmsBQShqt8exUjv6hECicKHPr5PbkMvGakVTiQh mbqPk+BEo1HB93AG9zthWdlCxDuZXWqEfCko/2PbCWHbw1+s8wpSOySrje9Sgfn/VXCM0h NGu6tyAoOPDiGYahiL8c0cjBSahXTAfv3luoGryulraY671hMnWtRIWcGkcF1K4OAiGWKK juK+gef0Ho5O7bOWQXcpC67H7N4x/VJYRM6csycmVCYKIY0WwkNKLolDrypIdX6AKaby2x PqcbHNny14xISjWumjIrGpfRaW+e44MRGFIoS8NcAIqfkMhaNPLsWBtPzsIdwQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1638374157; a=rsa-sha256; cv=none; b=eO5YYucA/1tVOn1OO24Cke9/eubWs3OwzEifOxww4KGW/zhpwT574xBgmkna40Di84W3NR GYz156JHTg5lfZMIfx2oJq8YNSXGCtZUQiXerZ68+1iEYpdcImqOs0AhOSaMh985GVS6OR Tz3WfrKpdbrPgaCoa54oCUhlhx5Y0KfrbAKKc8ilBDY6ukM0I4f4Eilv9hUskJkPBFIU1B bDxiXg8FeFrc2poqcsW6IE+v2mouirUtZZLSFga919bDImQuOooQ+T8CjYsqDXAxBJFBhV PvmvmlgZpsMaNzvLASBS3Lg3L7eRRxT6I0W2dawUpRMED1elq6JI7ty1y1ApOg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=623e4e0dfcb0488bb5e07ee817daac167a9181cb commit 623e4e0dfcb0488bb5e07ee817daac167a9181cb Author: Fernando Apesteguía AuthorDate: 2021-12-01 15:53:25 +0000 Commit: Fernando Apesteguía CommitDate: 2021-12-01 15:53:25 +0000 [phb][en] Fix c-plus-plus tag We have removed the c-plus-plus tag. Fix so we render the Porter's Handbook properly Fixes: 64acd169b8 --- documentation/content/en/books/porters-handbook/uses/_index.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc index 6e9d00d041..977838f1f3 100644 --- a/documentation/content/en/books/porters-handbook/uses/_index.adoc +++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc @@ -18,6 +18,7 @@ tags: ["uses", "macros", "introduction", "guide"] :partnums: :source-highlighter: rouge :experimental: +:c-plus-plus: c++ :images-path: books/porters-handbook/ ifdef::env-beastie[] From nobody Thu Dec 2 00:25:10 2021 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 B9B5918B8963 for ; Thu, 2 Dec 2021 00:25:10 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4J4Gtt3QP9z3M8P; Thu, 2 Dec 2021 00:25:10 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 5547D13470; Thu, 2 Dec 2021 00:25:10 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1B20PASG000781; Thu, 2 Dec 2021 00:25:10 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1B20PAuI000780; Thu, 2 Dec 2021 00:25:10 GMT (envelope-from git) Date: Thu, 2 Dec 2021 00:25:10 GMT Message-Id: <202112020025.1B20PAuI000780@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: fdb60ee92c - main - 12.3: RELEASE builds have started 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gjb X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: fdb60ee92c3c502228f05b0b5ee6ecc998d26bc8 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1638404710; 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; bh=ADOwCTwJJ74DW+pI7JufPca5xUwuM9/76wbK0cwcvvQ=; b=dH7dbZA/HkvYToqkpStk5sOTN2o6gUjj8sFyI/Y7fhlo4daxBae+spf8ldqqtPW1e1q1Xw rIlTbeh9U29BNpKedhu3wfOJGTbHEOtm+Xvp0IBFkj/Hrh9BGIbv8NIsq0ikHG+z8+HvJv yuDS6a0as/NyA3HKexzRb96XCl/WDlA+XUZdwQgJTLGPcYxLd4i/9GkbPpPzhgdQDbxUMF B4NovOVMcWC4bdBJ48VNWSJKKfy/mY3mOhTKAHWMOmEhr5p8NAYVXjDSzw6pElHPahwyZc PUIViwCIjW+pMtc1yF1F7/XJ3F/9WRirVSn+OGAlcPa5jK2X1yTLiVMx8w0Njg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1638404710; a=rsa-sha256; cv=none; b=qInUinAAZjlanZTv2btjO0pHvR63SDzsFeGCzWwQ5LdHHWkn213UE+6xo/97Ai4/UfIsmA YhXUOTmt+pRTtkoZTLcG1E4rdmGK8q+IHw3+cl/5vGDWrI/1D4gRWAjwBAZVobgW5U2NmM Dbt3a/CiJdvfRgiBYW18ZnUD/V07e7TutT2nuooxVtTwHiN8/jmI3wJtByuBtnis6WMaqB OjWcSECbIevgtfb4NPAChisxiex3B0NOYPIYEJXlfTJVmS6eX9Wg7umhC513al7qBw0o5m Vo0nA4jfM0vKpzLmmniJTBm5+/4p/TeT+1XXViNUIy5LJGhkZ0FWjDN0Y2KHKA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=fdb60ee92c3c502228f05b0b5ee6ecc998d26bc8 commit fdb60ee92c3c502228f05b0b5ee6ecc998d26bc8 Author: Glen Barber AuthorDate: 2021-12-02 00:24:46 +0000 Commit: Glen Barber CommitDate: 2021-12-02 00:24:46 +0000 12.3: RELEASE builds have started Sponsored by: Rubicon Communications, LLC ("Netgate") --- website/content/en/releases/12.3R/schedule.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/releases/12.3R/schedule.adoc b/website/content/en/releases/12.3R/schedule.adoc index 95ecea28e2..64b7a34cd9 100644 --- a/website/content/en/releases/12.3R/schedule.adoc +++ b/website/content/en/releases/12.3R/schedule.adoc @@ -36,7 +36,7 @@ link:{handbook}#mfc-glossary[MFC] requests are no longer being accepted. |RC1 builds begin |11 November 2021 |11 November 2021 |First release candidate. |RC2 builds begin |18 November 2021 |18 November 2021 |Second release candidate. |RC3 builds begin |25 November 2021 |(not needed) |Third release candidate. -|RELEASE builds begin |2 December 2021 |- |{localRel}-RELEASE builds begin. +|RELEASE builds begin |2 December 2021 |2 December 2021 |{localRel}-RELEASE builds begin. |RELEASE announcement |6 December 2021 |- |{localRel}-RELEASE press release. |Turn over to the secteam |- |- |{localBranchReleng} branch is handed over to the FreeBSD Security Officer Team in one or two weeks after the announcement. |=== From nobody Thu Dec 2 20:01:09 2021 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 CF33918C6459 for ; Thu, 2 Dec 2021 20:01:09 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4J4mzn3RSlz4jLr; Thu, 2 Dec 2021 20:01:09 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 564AB2388F; Thu, 2 Dec 2021 20:01:09 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1B2K196t072710; Thu, 2 Dec 2021 20:01:09 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1B2K196v072709; Thu, 2 Dec 2021 20:01:09 GMT (envelope-from git) Date: Thu, 2 Dec 2021 20:01:09 GMT Message-Id: <202112022001.1B2K196v072709@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Daniel Ebdrup Jensen Subject: git: fbb8fe5553 - main - website/docproj: Correct link to wiki article 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: debdrup X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: fbb8fe55531a972dfaa321fbf126d45b3909260c Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1638475269; 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; bh=EuiQAwOurpTZMBf2LC6BNaW37A2jrJIgULP5IrZCrnE=; b=T93ugJE/1XaWZ4oVWRTidLReHVPBLYwkzR0xRdpOe87DE0lRWEUO1Ph/ELpQX0umvJrQEg wd2DuCKAfHbpOfUKW2Sae5isYXZSFwYmELvkhQB8vRJ1EDVCeOFNf6xE2+DK51B152VzgH P9P0jc55B16kbgRKniwSQvdJ9PIm5saP4yv/Vw3w1qC8sYmSQ5pNuSPO+eAAx8k1L6Cqbe PYe+JVbZM7RbIuQ8U5g2G9qLXQ6rgDoSLfKI2BtiGl31SLw35FotGAzZ7CVbXo0CFGMVsN cpHPOlISQZaURVKyZ/HCodjEHoFsuBqpF25EE2PeDiSfkIjdobqZsCEa8K2qfA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1638475269; a=rsa-sha256; cv=none; b=Hqop4wyNdrkoMz1aTYHjGEayl5SajGUjTBOy8aFvKVzXh8klvPdP3tkAYvUPrU6rmBLdV3 L46oNiSwdEP9OlnpETac/B/+33dWlbQXIfWwf0OE0t380ws/nbVdDLNteB+Fk4QNFpZXC4 n2cWYACceoePWFKyg1MtdrzAalSoweaksqp3cpVwTenhhZLePddIE438e6xrg4V4ti/r2P yFoQNMSyOEK8cU6/n55JybxrIu4qTfFQNvg/MRP7gy8VHl0cGvzvf6ak1wLuzhMGEmWP4B 9VEdTQek7WEZgi5C4pttzHHCjEsnPIFYtgzeNrtOqtdS/+i9GGKN1BAy+RWWxg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by debdrup: URL: https://cgit.FreeBSD.org/doc/commit/?id=fbb8fe55531a972dfaa321fbf126d45b3909260c commit fbb8fe55531a972dfaa321fbf126d45b3909260c Author: Daniel Ebdrup Jensen AuthorDate: 2021-12-02 19:46:34 +0000 Commit: Daniel Ebdrup Jensen CommitDate: 2021-12-02 20:00:45 +0000 website/docproj: Correct link to wiki article A new ideas list page was added by dbaio@ on 2021-06-17, so to ensure that people get sent to the correct place, update the link in the documentation. I've also setup a redirect on the wiki, to catch extranenous links from places outside of project control. PR: 260179 Reported by: PauAmma, parv (on IRC) --- website/content/en/docproj/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/docproj/_index.adoc b/website/content/en/docproj/_index.adoc index 2f92e137dc..a673e96343 100644 --- a/website/content/en/docproj/_index.adoc +++ b/website/content/en/docproj/_index.adoc @@ -26,7 +26,7 @@ a| [.center] === Current projects -There are a number of projects currently _in progress_ as part of the documentation effort. Please take the time to look over https://wiki.freebsd.org/DocIdeaList[the current list of projects] and see if there is anything *you* can help with. +There are a number of projects currently _in progress_ as part of the documentation effort. Please take the time to look over https://wiki.freebsd.org/Doc/IdeaList[the current list of projects] and see if there is anything *you* can help with. |=== == link:who[Who we are, how to join]