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

Make an editing pass through the 2017Q3 report

Browse source
This commit is contained in:
Benjamin Kaduk 2017-12-17 19:18:37 +00:00
parent 740605f21d
commit 4219f0bc4b
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=51318
1 changed files with 86 additions and 87 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

173
en_US.ISO8859-1/htdocs/news/status/report-2017-07-2017-09.xml
View file

@ -104,7 +104,7 @@
<description>Miscellaneous</description> <description>Miscellaneous</description>
<p>Objects that defy categorization.</p> <p>Items that defy categorization.</p>
</category> </category>
<category> <category>
@ -187,14 +187,14 @@
<ul> <ul>
<li>The CPU topology detection code was enhanced to properly <li>The CPU topology detection code was enhanced to properly
detect Zen dies and CCXes. This gives the scheduler more detect Zen dies and CPU Complexes. This gives the scheduler more
locality information to make scheduling decisions.</li> locality information to use when making scheduling decisions.</li>
<li>The x86 topology analysis was enhanced to report dies and <li>The x86 topology analysis was enhanced to report dies and
CCXes, in addition to the existing reporting on packages, CPU Complexes, in addition to the existing reporting on packages,
cores, and threads. An example of the new output is cores, and threads. An example of the new output is
&quot;FreeBSD/SMP: 1 package(s) x 2 groups x 2 cache groups <tt>FreeBSD/SMP: 1 package(s) x 2 groups x 2 cache groups
x 4 core(s) x 2 hardware threads&quot;.</li> x 4 core(s) x 2 hardware threads</tt>.</li>
<li>The amdsmn(4) driver for accessing SMN (System Management <li>The amdsmn(4) driver for accessing SMN (System Management
Network) registers was added.</li> Network) registers was added.</li>
@ -204,29 +204,30 @@
<li>In cpufreq(4): <li>In cpufreq(4):
<ul> <ul>
<li>Added support for decoding Zen P-state info from MSRs <li>Added support for decoding Zen P-state information
(mostly not necessary due to ACPI P-state information, from Machine State Registers (which is usually not
but potentially useful)</li> necessary, since it is largely redundant with ACPI
P-state information, but is potentially useful)</li>
<li>Work around the apparent Ryzen inability to achieve <li>Work around the apparent Ryzen inability to achieve
the P1 state by not busying cores waiting to the P1 state by not busying cores waiting to
transition.</li> transition to it</li>
</ul> </ul>
</li> </li>
<li>The intpm(4) smbus driver was fixed to attach to FCH <li>The intpm(4) smbus driver was fixed to attach to the AMD
(Fusion Controller Hub).</li> FCH (Fusion Controller Hub).</li>
<li>All MCA banks are now enabled and monitored on Zen <li>All MCA banks are now enabled and monitored on Zen
CPUs.</li> CPUs.</li>
<li>Feature bit decoding was added for: CLZERO, SVM features, <li>Feature-bit decoding was added for: CLZERO, SVM features,
RAS capabilities.</li> and RAS capabilities.</li>
<li>SHA intrinsic support was added to the aesni(4) driver. <li>SHA intrinsic support was added to the aesni(4) driver.
Ryzen is currently the only desktop processor to feature Ryzen is currently the only desktop processor to feature
these intrinsics. Support is also present in Intel's these intrinsics. Support for these intrinsics is also
Goldmont line of low end SoCs.</li> present in Intel's Goldmont line of low-end SoCs.</li>
</ul> </ul>
<p>Overall, Zen is now a very usable platform for x86 <p>Overall, Zen is now a very usable platform for x86
@ -236,8 +237,8 @@
<sponsor>Dell EMC Isilon</sponsor> <sponsor>Dell EMC Isilon</sponsor>
<help> <help>
<task>Add HWPMC support for new performance counters in <task>Add HWPMC support for the new performance counters
Zen.</task> avilable on the Zen architecture.</task>
<task>Add support for the CCP (Crypto Co-Processor).</task> <task>Add support for the CCP (Crypto Co-Processor).</task>
</help> </help>
@ -359,16 +360,18 @@
<body> <body>
<p>This summer has seen the creation of a puppet@ team to help <p>This summer has seen the creation of a puppet@ team to help
maintain the ~30 Puppet-related ports in the &os; ports tree. maintain the approximately 30 Puppet-related ports in the &os;
ports tree.
These ports were previously maintained by various committers, These ports were previously maintained by various committers,
and from time to time this introduced some delays when and from time to time the distributed maintainership
updating a port due to the need to wait for a maintainer's introduced some delays when
updating a port due, to the need to wait for a maintainer's
approval for a related change to a different port.</p> approval for a related change to a different port.</p>
<p>Puppet 5 is now in the ports tree (as <p>Puppet 5 is now in the ports tree (as
<tt>sysutils/puppet5</tt>). The C++ version of Facter <tt>sysutils/puppet5</tt>). The C++ version of Facter
(<tt>sysutils/facter</tt>) got a lot of love and is now a (<tt>sysutils/facter</tt>) got a lot of love and is now a
drop-in replacement for the previous Ruby version of Facter drop-in replacement for the previous Ruby version
(<tt>sysutils/rubygem-facter</tt>); it is the default facts (<tt>sysutils/rubygem-facter</tt>); it is the default facts
source for the Puppet 5 port.</p> source for the Puppet 5 port.</p>
@ -377,7 +380,7 @@
</body> </body>
<help> <help>
<task>The <tt>pkgng</tt> package provider has some minor issues <task>The <tt>pkg</tt> package provider has some minor issues
(it breaks things when no repos are configured, and is not (it breaks things when no repos are configured, and is not
working properly from the context of the MCollective package working properly from the context of the MCollective package
agent).</task> agent).</task>
@ -411,7 +414,7 @@
<p>iWARP is a protocol suite that enables efficient movement <p>iWARP is a protocol suite that enables efficient movement
of data across the network, building on Remote Direct Memory of data across the network, building on Remote Direct Memory
Access, Direct Data Placement, and Marker PDU Aligned Framing. Access, Direct Data Placement, and Marker PDU Aligned Framing.
It endeavors to avoid unnecessary (local) data copies and It endeavors to avoid unnecessary (local) data copies and to
offload work from the main CPU to dedicated hardware.</p> offload work from the main CPU to dedicated hardware.</p>
<p>An initial commit adding iWARP support for the Intel X722 <p>An initial commit adding iWARP support for the Intel X722
@ -460,10 +463,10 @@
<p>This quarter, with the help of Matt Macy and Sean Bruno (among <p>This quarter, with the help of Matt Macy and Sean Bruno (among
others), we've submitted a review in Phabricator for the others), we've submitted a review in Phabricator for the
conversion of the <tt>ixgbe</tt> driver to use the new (and evolving) conversion of the <tt>ixgbe</tt> driver to use the new (and evolving)
<tt>iflib</tt> interface.</p> <tt>iflib</tt> framework.</p>
<p>Stay tuned for the conversion of the 40G driver <p>Stay tuned for the conversion of the 40G driver
(<tt>ixl</tt>) as it is currently being ported to use (<tt>ixl</tt>), as it is currently being ported to use
<tt>iflib</tt>.</p> <tt>iflib</tt>.</p>
</body> </body>
@ -510,19 +513,19 @@
</contact> </contact>
<links> <links>
<url href="https://github.com/FreeBSDDesktop/">FreeBSDDesktop GitHub</url> <url href="https://github.com/FreeBSDDesktop/">FreeBSDDesktop on GitHub</url>
</links> </links>
<body> <body>
<p>The FreeBSDDesktop team is happy to announce the availability of <p>The FreeBSDDesktop team is happy to announce the availability of
<tt>graphics/drm-next-kmod</tt>. This port for &os; CURRENT <tt>graphics/drm-next-kmod</tt>. This port for &os;-CURRENT
(amd64) provides support for the <tt>amdgpu</tt>, (amd64) provides support for the <tt>amdgpu</tt>,
<tt>i915</tt>, and <tt>radeon</tt> DRM <tt>i915</tt>, and <tt>radeon</tt> DRM
modules using the <tt>linuxkpi</tt> compatibility framework. modules using the <tt>linuxkpi</tt> compatibility framework.
The port currently corresponds to DRM from Linux 4.9 and is in The port currently corresponds to the DRM from Linux 4.9 and is in
an experimental state. It works reliably for a lot of testers an experimental state. It works reliably for many testers
with modern GPU hardware (AMD HD7000 series/Tahiti to Polaris with modern GPU hardware (AMD HD7000 series/Tahiti to Polaris
and Intel HD3000/Sandy Bridge to Skylake). Broader testing and and Intel HD3000/Sandy Bridge to Skylake). Broader testing and
reporting/fixing of bugs is appreciated.</p> </body> reporting/fixing of bugs is appreciated.</p> </body>
<help> <help>
@ -557,15 +560,15 @@
</links> </links>
<body> <body>
<p>OpenJFX is an open source, next generation client <p>OpenJFX is an open source, next generation, client
application platform for desktop and embedded systems application platform for desktop and embedded systems,
based on JavaSE. This quarter, the OpenJFX port was based on JavaSE. This quarter, the OpenJFX port was
reworked and has some significant improvements.</p> reworked and has received some significant improvements.</p>
<p>More modules are being built. With the new web module we <p>More modules are being built. With the new web module we
gain support for applications that have their own builtin gain support for applications that have their own builtin
web browser like e.g. AsciidocFX. The new media module web browser such as AsciidocFX. The new media module
allows JavaFX applications to playback audio and video allows JavaFX applications to play audio and video
files.</p> files.</p>
<p>A port of the JavaFX scenebuilder, a RAD tool for <p>A port of the JavaFX scenebuilder, a RAD tool for
@ -581,7 +584,7 @@
</body> </body>
<help> <help>
<task>Upstream some of the patches</task> <task>Upstream some of the patches in the ports tree.</task>
</help> </help>
</project> </project>
@ -614,14 +617,14 @@
</links> </links>
<body> <body>
<p>The Ports Collection now features over 31,600 ports. There are currently <p>The Ports Collection now features over 31,600 ports. There are currently
2671 problem reports, of which 718 are unassigned. This quarter saw 2671 problem reports, of which 718 are unassigned. This quarter saw
almost 5,900 commits from 175 committers. The number of open PRs grew almost 5,900 commits from 175 committers. The number of open PRs grew
compared to last quarter, and outpaced the number of changes.</p> compared to last quarter, and outpaced the number of changes.</p>
<p>This quarter, we welcomed Zach Leslie (zleslie@), Luca Pizzamiglio <p>This quarter, we welcomed Zach Leslie (zleslie@), Luca Pizzamiglio
(pizzamig@), Craig Leres (leres@), Adriaan de Groot (adridg@), and Dave (pizzamig@), Craig Leres (leres@), Adriaan de Groot (adridg@), and Dave
Cottlehuber (dch@) as new committers. The commit bits of the following Cottlehuber (dch@) as new committers. The commit bits of the following
committers were taken in for safekeeping: alonso@ after 19 months of committers were taken in for safekeeping: alonso@ after 19 months of
inactivity, rpaulo@ per his request, and ache@ after he passed away. inactivity, rpaulo@ per his request, and ache@ after he passed away.
Despite several tries and changing mentors, kami@ lacked interest in Despite several tries and changing mentors, kami@ lacked interest in
@ -638,14 +641,14 @@
<li><tt>twisted</tt>: there is only one Twisted port left</li> <li><tt>twisted</tt>: there is only one Twisted port left</li>
</ul> </ul>
<p>The default version of GCC was bumped from 5 to 6. Firefox was updated <p>The default version of GCC was bumped from 5 to 6. Firefox was updated
to version 56.0 and Chromium to version 61.0.3163.100. The version of to version 56.0 and Chromium to version 61.0.3163.100. The version of
<tt>pkg</tt> itself was updated to 1.10.1.</p> <tt>pkg</tt> itself was updated to 1.10.1.</p>
<p>During this quarter, antoine@ performed 28 exp-runs to test version <p>During this quarter, antoine@ performed 28 exp-runs to test version
updates of major ports, improving <tt>USE_GITHUB</tt> and updates of major ports, improving <tt>USE_GITHUB</tt> and
<tt>SHEBANG_FILES</tt>, and API changes to the base system. <tt>SHEBANG_FILES</tt>, and API changes to the base system.
This quarter, the foundations for ports &quot;flavors&quot; were This quarter, the foundation for ports &quot;flavors&quot; was
committed, though more development and testing will be committed, though more development and testing will be
performed in the coming quarter before it goes live.</p> performed in the coming quarter before it goes live.</p>
</body> </body>
@ -688,7 +691,7 @@
<li><a href="https://artifact.ci.FreeBSD.org/dtrace-test/">https://artifact.ci.FreeBSD.org/dtrace-test/</a></li> <li><a href="https://artifact.ci.FreeBSD.org/dtrace-test/">https://artifact.ci.FreeBSD.org/dtrace-test/</a></li>
</ul> </ul>
<p>We had 2 developer summits in Q3:</p> <p>We had a team meeting at two developer summits during Q3:</p>
<ul> <ul>
<li><a href="https://wiki.FreeBSD.org/DevSummit/201708/Testing">BSDcam</a></li> <li><a href="https://wiki.FreeBSD.org/DevSummit/201708/Testing">BSDcam</a></li>
@ -697,7 +700,7 @@
</body> </body>
<help> <help>
<task>Fix the failing cases and builds.</task> <task>Fix the failing test cases and builds.</task>
<task>Create builds for additional architectures.</task> <task>Create builds for additional architectures.</task>
@ -745,7 +748,7 @@
<p>In addition to Fedor Uporov, please also welcome (in no <p>In addition to Fedor Uporov, please also welcome (in no
particular order) Matt Joras, Marcin Wojtas, Chuck Tuffli, Ilya particular order) Matt Joras, Marcin Wojtas, Chuck Tuffli, Ilya
Bakulin and Alex Richardson as brand new committers. We have also Bakulin and Alex Richardson as brand-new committers. We have also
awarded Steven Hurd and Eugene Grosbein src commit bits to go with awarded Steven Hurd and Eugene Grosbein src commit bits to go with
their existing ports bits. Welcome back Gordon Tetlow as a src their existing ports bits. Welcome back Gordon Tetlow as a src
committer, essential for his new role within secteam. Eric Davis committer, essential for his new role within secteam. Eric Davis
@ -797,7 +800,7 @@
However, this does not necessarily meet the needs of downstream However, this does not necessarily meet the needs of downstream
projects based on &os;, and given the new "packaged base", projects based on &os;, and given the new "packaged base",
adding per-package licensing metadata in a way similar to how adding per-package licensing metadata in a way similar to how
the Ports Collectionworks is under consideration as an alternative the Ports Collection works is under consideration as an alternative
mechanism.</li> mechanism.</li>
</ul> </ul>
@ -809,15 +812,16 @@
report was edited for length and to concentrate on activities report was edited for length and to concentrate on activities
during the quarter in question.</p> during the quarter in question.</p>
<p>Amazon is proposing to set up mirrors of the FreeBSD-update and <p>Amazon is proposing to set up mirrors of the <tt>freebsd-update</tt> and
<tt>pkg</tt> servers within AWS in order to provide faster <tt>pkg</tt> servers within AWS in order to provide faster
access for EC2 users. These mirrors will be publicly access for EC2 users. These mirrors will be publicly
accessible, but the expectation is that use will primarily be accessible, but the expectation is that use will primarily be
from within EC2. &os; AMIs will have a preset configuration from within EC2. &os; AMIs will have a preset configuration
that references the Amazon servers.</p> that references the Amazon servers.</p>
<p>The old, long deprecated and insecure &quot;r-commands&quot; (rsh, <p>The old, long-deprecated, and insecure &quot;r-commands&quot;
rlogin, rcp) are being removed from the base system for (<tt>rsh</tt>, <tt>rlogin</tt>, <tt>rcp</tt>) are being removed
from the base system for
12.0-RELEASE. Notice of this was added to the man pages and 12.0-RELEASE. Notice of this was added to the man pages and
release notes in time for 11.1-RELEASE and 10.4-RELEASE. Anyone release notes in time for 11.1-RELEASE and 10.4-RELEASE. Anyone
requiring these commands for backwards compatibility can use the requiring these commands for backwards compatibility can use the
@ -859,7 +863,7 @@
<links> <links>
<url href="https://www.FreeBSDFoundation.org/">FreeBSD Foundation Website</url> <url href="https://www.FreeBSDFoundation.org/">FreeBSD Foundation Website</url>
<url href="https://www.FreeBSDfoundation.org/wp-content/uploads/2017/08/&os;-Foundation-July-August-2017-Update.pdf">FreeBSD Foundation Quarterly Newsletter</url> <url href="https://www.FreeBSDfoundation.org/wp-content/uploads/2017/08/FreeBSD-Foundation-July-August-2017-Update.pdf">FreeBSD Foundation Quarterly Newsletter</url>
</links> </links>
<body> <body>
@ -885,10 +889,10 @@
<p>Fundraising Efforts</p> <p>Fundraising Efforts</p>
<p>Our work is 100% funded by your donations. This year we've <p>Our work is 100% funded by your donations. This year we've
raised over $860,000 from 500+ donors. Our 2017 fundraising raised over $860,000 from over 500 donors. Our 2017 fundraising
goal is $1,250,00 and we are continuing to work hard to meet goal is $1,250,00 and we are continuing to work hard to meet
and exceed this goal! Please consider making a donation to and exceed this goal! Please consider making a donation to
help us continue and increase our support for &os;. <a help us continue and increase our support for &os;: <a
href="https://www.FreeBSDfoundation.org/donate/">https://www.&os;foundation.org/donate/</a>.</p> href="https://www.FreeBSDfoundation.org/donate/">https://www.&os;foundation.org/donate/</a>.</p>
<p>We also have a new Partnership Program, to provide more benefits <p>We also have a new Partnership Program, to provide more benefits
@ -917,11 +921,11 @@
<li>Broadcom Wi-Fi infrastructural improvements <li>Broadcom Wi-Fi infrastructural improvements
(<tt>bhnd(4)</tt> driver)</li> (<tt>bhnd(4)</tt> driver)</li>
<li>Headless mode out of the box &mdash; Beaglebone Black</li> <li>Headless mode out-of-the-box for the Beaglebone Black</li>
<li>Extending bhyve-ARMv7 features</li> <li>Extending <tt>bhyve</tt>/ARMv7 features</li>
<li>Porting <tt>bhyve-arm</tt> to an ARMv8 platform</li> <li>Porting <tt>bhyve</tt>ARM to an ARMv8 platform</li>
</ul> </ul>
<p>Having software developers on staff has allowed us to jump in <p>Having software developers on staff has allowed us to jump in
@ -938,7 +942,7 @@
<li>Stack guard</li> <li>Stack guard</li>
<li>Kernel Undefined Behavior sanitizer</li> <li>Kernel Undefined Behavior Sanitizer</li>
<li>Toolchain projects</li> <li>Toolchain projects</li>
@ -956,11 +960,6 @@
conference calls to facilitate efforts for individuals to conference calls to facilitate efforts for individuals to
collaborate on different technologies.</p> collaborate on different technologies.</p>
<p>You can find out more about the support we provided by
reading individual updates from Ed Maste, Konstatin Belousov,
Landon Fuller, Matt Ahrens, and Edward Napierala in this
report.</p>
<p>Release Engineering</p> <p>Release Engineering</p>
<p>The Foundation provides a full-time staff member to lead the <p>The Foundation provides a full-time staff member to lead the
@ -1037,13 +1036,13 @@
<li>Proved travel grants to &os; contributors to attend the <li>Proved travel grants to &os; contributors to attend the
above events.</li> above events.</li>
<li>Industry Partner for 2017 USENIX Security Symposium in <li>Sponsored the 2017 USENIX Security Symposium in Vancouver
Vancouver BC</li> BC as an Industry Partner</li>
<li>Provided &os; advocacy material</li> <li>Provided &os; advocacy material</li>
<li>Industry Partner for 2017 USENIX Annual Technical <li>Supported the 2017 USENIX Annual Technical Conference in
Conference in Santa Clara, CA</li> Santa Clara, CA as an Industry Partner</li>
</ul> </ul>
<p>We continued producing &os; advocacy material to help <p>We continued producing &os; advocacy material to help
@ -1054,7 +1053,7 @@
published the July/August issue that you can find at <a published the July/August issue that you can find at <a
href="https://www.FreeBSDfoundation.org/journal/">https://www.&os;foundation.org/journal/</a>.</p> href="https://www.FreeBSDfoundation.org/journal/">https://www.&os;foundation.org/journal/</a>.</p>
<p>You can find out more about events we were at and upcoming <p>You can find out more about events we attended and upcoming
events at <a events at <a
href="https://www.FreeBSDfoundation.org/news-and-events/">https://www.FreeBSDfoundation.org/news-and-events/</a>.</p> href="https://www.FreeBSDfoundation.org/news-and-events/">https://www.FreeBSDfoundation.org/news-and-events/</a>.</p>
@ -1090,9 +1089,9 @@
<body> <body>
<p>A pNFS server allows an NFS service to be spread over <p>A pNFS server allows an NFS service to be spread over
multiple servers, separating the MetaData operations from the multiple servers, separating the MetaData operations from the
Data operations (Read/Write). This project will add the Data operations (Read and Write). This project will add the
capability of using &os; systems to create a pNFS service ability to use &os; systems to create a pNFS service
consisting of a single MetaData Server, plus a set of Data consisting of a single MetaData Server plus a set of Data
Servers. The Data Servers can be mirrored, so that redundant Servers. The Data Servers can be mirrored, so that redundant
copies of the file data are maintained.</p> copies of the file data are maintained.</p>
@ -1107,8 +1106,8 @@
next six months.</p> next six months.</p>
<p>The patched &os; sources may now be accessed for testing <p>The patched &os; sources may now be accessed for testing
via either Subversion or download of a gzipped tarball. via either Subversion or downloading a gzipped tarball.
They consist of a patched kernel plus nfsd daemon and can be They consist of a patched kernel and <tt>nfsd</tt> and can be
used on any &os; 11 or later system. The installation used on any &os; 11 or later system. The installation
procedure is covered in the linked document.</p> procedure is covered in the linked document.</p>
</body> </body>
@ -1121,7 +1120,7 @@
</help> </help>
</project> </project>
<project cat="proj"> <project cat="third">
<title>The <tt>nosh</tt> Project</title> <title>The <tt>nosh</tt> Project</title>
<contact> <contact>
@ -1144,14 +1143,14 @@
</links> </links>
<body> <body>
<p>The nosh project is a suite of system-level utilities for <p>The <tt>nosh</tt> project is a suite of system-level utilities for
initializing, running, and shutting down BSD systems; and for initializing, running, and shutting down BSD systems; and for
managing daemons, terminals, and logging. It attempts to managing daemons, terminals, and logging. It attempts to
supersede BSD <tt>init</tt>, the Mewburn <tt>rc.d</tt> system, supersede BSD <tt>init</tt>, the Mewburn <tt>rc.d</tt> system,
and OpenRC as used on &os; and TrueOS, drawing inspiration and OpenRC as used on &os; and TrueOS, drawing inspiration
from Solaris SMF for named milestones, daemontools-encore for from Solaris SMF for named milestones, daemontools-encore for
service control/status mechanisms, UCSPI, and IBM AIX for service control/status mechanisms, UCSPI, and IBM AIX for
separated service and system management. It comprises a range separated service and system management. It includes a range
of compatibility mechanisms, including shims for familiar of compatibility mechanisms, including shims for familiar
commands from other systems, and an automatic import mechanism commands from other systems, and an automatic import mechanism
that takes existing configuration data from that takes existing configuration data from
@ -1170,10 +1169,10 @@
<p>Since the last status report, in December 2015, the project <p>Since the last status report, in December 2015, the project
has seen: restructured and finer-grained packaging that has has seen: restructured and finer-grained packaging that has
fewer conflicts with other toolsets; the addition of fewer conflicts with other toolsets; the addition of
<tt>zsh</tt> completion files; improvements to the vertual <tt>zsh</tt> completion files; improvements to the virtual
terminal subsystem, keyboard map, mouse support, and ugen and terminal subsystem, keyboard map, mouse support, and ugen and
DECSCUSR support; RFC 5424/5426 remote logging support; DECSCUSR support; RFC 5424/5426 remote logging support;
replacement of the libkqueue and the C library's environment replacement of libkqueue and the C library's environment
handling functions; several new helper commands; support for handling functions; several new helper commands; support for
Java VM autolocation; improved socket-passing code; an Java VM autolocation; improved socket-passing code; an
extended status API and &quot;one-shot&quot; service support; extended status API and &quot;one-shot&quot; service support;
@ -1252,13 +1251,13 @@
new ones.</p> new ones.</p>
<p>In September, I added a new chapter to the <p>In September, I added a new chapter to the
<a href="https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/">&os;Documentation <a href="https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/">&os;
Project Primer</a> describing the basics of creating a man Documentation Project Primer</a> describing the basics of
page. It includes descriptions of the markup, section creating a man page. It includes descriptions of the
structure, recommended optional material such as examples, markup, section structure, recommended optional material
and sample templates for the most common types of man pages. such as examples, and sample templates for the most common
The Resources section includes links to several external types of man pages. The Resources section includes links to
resources, including the excellent <a several external resources, including the excellent <a
href="http://manpages.bsd.lv/mdoc.html">Practical UNIX href="http://manpages.bsd.lv/mdoc.html">Practical UNIX
Manuals: mdoc</a>.</p> Manuals: mdoc</a>.</p>
@ -1268,7 +1267,7 @@
</body> </body>
<help> <help>
<task>Add more explanation and examples of markup.</task> <task>Add more explanation and examples of markup usage.</task>
<task>Expand the sample templates with additional desired standard <task>Expand the sample templates with additional desired standard
features, like an EXAMPLES section.</task> features, like an EXAMPLES section.</task>