now contained entirely in a single DocBook article, which has
information pertinent to all architectures. This will improve
the maintainability of the hardware notes going forward by
reducing complexity of the build process, improving the visibiilty
of the architecture-specific text, and removing the need to generate
an extra version of the document for every architecture.
Remove all of the MD hardware notes stuff; all relevant content
has been folded into hardware/article.sgml.
No objections from: freebsd-doc@
manner consistent with the new MI-style hardware notes document.
man2hwnotes.pl now defaults to generating entities for the MI-style
hardware notes (i.e. hardware/article.sgml). A new -c
option causes it to generate entities for the older MD-style
hardware notes (i.e. hardware/common/dev.sgml).
The Makefile infrastructure supplies the -c option to man2hwnotes.pl
now unless the HWNOTES_MI Makefile variable is defined, so
compatiblity is preserved for hardware notes translations that
aren't converted to the new organization yet. As translations
convert, they should define HWNOTES_MI in their hardware/Makefile.
When all the relevant translations catch up, the compatibility goop
in share/mk/doc.relnotes.mk and share/sgml/Makefile can be removed.
Thanks go to simon@ for help with the backwards compatiblity
mechanism.
Tested with: en_US.ISO8859-1, zh_CN.GB2312
Convert MD references in the supported devices section from arch=""
attributes for conditional compilation to entities that will just
print architecture names. (The entities aren't defined yet...this
will happen in a future commit.)
Rather than rendering a different version of the release notes for
every architecture, we now produce a single release notes document
that covers all architectures.
This change makes document maintenence easier (because there is no
longer a need to support each architecture specifically in the
src/release/doc/ and www/ build infrastructures). It's also
easier to read because there is now exactly one release notes document,
and readers can see changes that affected various subsets of
architectures.
Discussed on: -doc@
them unsigned I made the possible overflows hard to detect,
and it only saved 1 bit which isn't principal, even less now
that the underlying issue with the total of virtual memory has
been fixed. (For the record, it will overflow with >=2T of
VM total, with 32-bit ints used to keep counters in pages.)
- While here, fix printing of other "struct vmtotal" members
such as t_rq, t_dw, t_pw, and t_sw as they are also signed.
Reviewed by: bde
MFC after: 3 days
- Fix overflow bugs in sysctl(8), systat(1), and vmstat(8)
when printing values of "struct vmmeter" in kilobytes as
they don't necessarily fit into 32 bits. (Fix sysctl(8)
reporting of a total virtual memory; it's in pages too.)
packages on disc2. This will also let users decide if they want to
have a CD of the docs at all - unless they're disconnected from the
net they will probably find the Web site more useful.
Reviewed by: ru
MFC after: 3 days
