Update the hardware page to reflect CPU updates/additions
added in head@r273941.

Since the original commit requires changes to the doc/
repository after the release tag had already happened,
(re)define entities in share/xml/release.ent that reflect
doc@r45900 to prevent build breakage.

Requested by: gavin
Approved by: re (implicit, relnotes)
Sponsored by: The FreeBSD Foundation

- Correct the FreeBSD release displayed on the 10.1-R errata
page.
- Trim stale errata items from 10.0-RELEASE, but keep the
entry regarding FreeBSD/i386 on VirtualBox, as I am unsure
if the underlying cause was identified and/or corrected.
- Fix a few occurances of 'release.prev' macros that should
be 'release.current'. [1]
- Switch release.ent entities to reflect a release, and update
versions where appropriate.

Submitted by: pluknet [1]
Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

Copy stable/10@r272459 to releng/10.1 as part of
the 10.1-RELEASE process.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

MFC r271331:
Change how the recommended mailing list to track is
added to the footer of the release/doc/ pages by
moving a hard-coded value (that is subject to human
error to change) to release.ent where other values
are regularly changed, and adding parsing logic to
release.xsl.

Approved by: re (implicit, relnotes)
Sponsored by: The FreeBSD Foundation

Document r270997, zdb(8) included in /rescue.

Sponsored by: The FreeBSD Foundation

Document r270810, hptnr(4) update to 1.0.1.

Sponsored by: The FreeBSD Foundation

Document r267849, cxgbe(4) T4 and T5 firmwares update.
Add Chelsio vendor.ent entry.

Sponsored by: The FreeBSD Foundation

Drop 'Inc.' for consistency.

Sponsored by: The FreeBSD Foundation

Correct the spelling of iXsystems.

Submitted by: delphij
Sponsored by: The FreeBSD Foundation

Add sponsorship attributions for stable/10.
Add iX and Netflix to the sponsors.ent file.

This is a direct commit to stable/10.

Sponsored by: The FreeBSD Foundation

MFC r265590, r265594, r265595, r265599 [1], r265601 [1],
r265602 [1], r265603 [1], r265605 [1], r265607 [1],
r267554 [1]:

r265590:
Modify release.xsl to allow proper attribution for
sponsored and/or contributed works.

r265594:
Add two new entity files in followup to r265590,
sponsor.ent and vendor.ent, which will be used for
sponsor/vendor names and URLs.

r265595:
Add references to sponsor.ent and vendor.ent in
relnotes/article.xml and share/xml/catalog.xml.

r265599:
Add DARPA, AFRL to sponsor.ent.

r265601:
Add LSI and Spectra Logic to sponsor.ent.

r265602:
Add Netgate to sponsor.ent.

r265603:
Add a note to keep the entity lists sorted alphabetically.

r265605:
Add Google to the sponsor.ent file.

r265607:
Separate &darpa; entity and create &darpa_afrl to
avoid confusion.

r267554:
Add &citrix; and &citrix.rd; macros.

[1] - Partial, entity addition only.

Sponsored by: The FreeBSD Foundation

MFC: r265264, r265270

Add rsu(4) and urtwn(4) to the hardware notes.

MFC: r262574

Add tws(4) to the hardware notes.

MFC: r261487

Add qlxgbe(4) and qlxge(4) to the hardware notes.

- MFC 260653,260655:

* Purge old translations.
* Add missing footer due to DSSSL->XSLT migration and use XML catalog to
resolve URI.
* Add missing arch= and revision= support.

- Update release.ent and fix release number in Errata.

Update FreeBSD version entity values.
This is a direct commit to stable/10/, because the values differ
between stable/10/ and head/.

Sponsored by: The FreeBSD Foundation

MFC r257801 (gabor):
- Syncronize stable/10/release/doc with head/ in followup to
the docbook5.0 update to the doc/ repository.

Approved by: re (delphij)
Sponsored by: The FreeBSD Foundation

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

Revert r252126, r252124, r252121.

Submitted by: hrs

Add a new macro, release.current.release, to denote the head/ branch
with the -RELEASE suffix. This fixes the incorrect text on the -CURRENT
errata page from showing '10.0-CURRENT' followed by 'until 9.1-RELEASE is
released.'

- Update the release notes to DocBook 4.5 XML to build with the
updated documentation tree

Belatedly (by many years!) bump the version numbers in the src/-side
documentation pages.

Saddened by: this file

- Rename .sgml files to .xml to track the recent doc changes

MFC after: 1 day

Revert previous commit...

Pointyhat to: gjb (myself)

Fix man2hwnotes.pl script, which should fix the RELNOTES build.

Automatically generate hardware notes for bxe(4).

Add snd_hdspe(4) to the hardware notes.

Add isci(4) to the hardware notes.

MFC after: 3 days

Add oce(4) to the hardware notes.

MFC after: 3 days

Add support for the Em command. This restores a missing 'not' in the
description of snd_emu10kx(4).

Reviewed by: simon
MFC after: 1 week

Add hpt27xx to the hardware notes,

While here, add the 2012 copyright.

MFC after: 1 week

Add sfxge(4) to the hardware notes.

Add qlxgb(4) to the hardware notes.

MFC after: 3 days

Auto-generate hardware notes for vxge(4).

Approved by: re (kib)

Bump &release.manpath.*;.

Disconnect sun4v architecture from the three.

Some files keep the SUN4V tags as a code reference, for the future,
if any rewamped sun4v support wants to be added again.

Reviewed by: marius
Tested by: sbruno
Approved by: re

sis(4) should work on all architectures now.

Automatically generate hardware notes for run(4).

sk(4), stge(4) and vge(4) should work on all architectures, snd_t4dwave(4)
works on sparc64.

Submitted by: yongari

Remove ste(4), it should work on all architectures now.

Bump version numbers and update descriptions for the 9-CURRENT
world. The %[no]include.historic knobs are removed because they
are not used for a long time.

In lists, if there is a Li command remove it. This fixes markup for
uath(4).

MFC after: 3 days
Reported by: Warren Block <wblock at wonkity.com>

nge(4) should work on all archs now.

The sr(4) driver is removed.

uscanner(4) has been removed, delete it from the hardware notes to
fix the build.

txp(4) should work on all architectures now.

ncr(4) is not supported on sparc64.

See also: r183762

- Add support for Pp command - this improves output for axe(4).
- Add support for .Fx, just in case somebody starts using it.
- Only add the arch information to the first para per manual page.
This improves output for axe(4), and generally seems to make sense
(I hope).
- Remove an unneeded line for non-compat mode.

- Add ARM as a platform under development.
- Bump copyright year.

awi(4) has been removed.

- Add ($paragraph$) for printed version.
- Fix a bug that role="" does not work when arch="" is not specified.

Move (define ($paragraph$)) to the marked section for HTML output.
It should not be applied to printed output.

Use role="merged" and arch="amd64,i386,..." attributes to mark a
paragraph as MFC'd or one for specific platforms. This should
make no content change with the rendered output.

vr(4) should work on all archs now, remove it from here.

The rr232x driver has been removed, kill it here as well.

sf(4) should work on all archs now, remove it from here.

Autogenerate hardware notes for hptrr(4).

Use "8-current" manpage entities.

Use the most recent Xorg manpage set that we have.

Bump version numbers to reflect that HEAD represents 8.0-CURRENT.

gem(4) works on all archs now.

Approved by: re (blanket)

Autogenerate hardware notes for ral(4) and ural(4).

Approved by: re (blanket)

Autogenerate hardware notes for rum(4).

Approved by: re (blanket)

Autogenerate hardware notes for zyd(4).

Approved by: re (blanket)

Factor out arch.* entities so we don't need to include them with
every one of the release documents.

Approved by: re (implicitly)

Autogenerate hardware notes entities for ath(4) for all platforms
on which it's included in the GENERIC kernel.

PR 115403
Approved by: re (implicitly)
MFC after: 5 days

Disconnect installation notes from the release documentation build.

Approved by: re (blanket for installation notes removal)

Autogenerate hardware notes for nfe(4) and nxge(4).

Approved by: re (blanket)

Fix the path to 7.0 online manual pages.

Autogenerate hardware notes for hptiop(4).

Autogenerate the hardware list for cxgb(4).

Reflect that the hardware notes article is now a MI document.

Add support for auto-generating hardware notes entries in a
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

Remove alpha-specific stuff from the hardware notes (these are mostly
in attributes for generating MD hardware, as well as a few alpha-only
paragraphs here and there).

While here, bump copyright date in dev.archlist.txt.

Autogenerate hardware notes for msk(4).

Teach release builds and release documentation snapshots that release
notes are no longer MD documents.

Regenerate for snd_spicds(4), snd_emu10kx(4) and snd_envy24ht(4).

Regenerate for snd_hda(4).

Note hardware supported by powerpc, based on GENERIC.

Add the bones for PowerPC release documentation. This has been
derived from ia64.

- Add more debugging information to make it simpler to understand
what's going on in cases where the "state engine" doesn't act as
expected, e.g. in the case of a list not being closed in the manual
page being parsed.
- Bump copyright year.

MFC after: 1 week

Autogenerate hardware notes for stge(4).

Add snd_envy24(4).

Change the myri10ge dev entity and all consumers to mxge.

Don't try to upload alpha-specific docs anymore.

Remove autogeneration of lnc(4) hardware notes before gnn blows it away.

Autogenerate hardware notes for rr232x(4).

sk(4) now also works on sparc64 (as of yongari's recent commits).

Autogenerate hardware notes for bce(4).

Remove uart(4) as it's supported on all architectures and that is the
default.

Autogenerate hardware notes for mfi(4).

Update version numbers in &release.*;.

Enable automatic hardware notes generation for myri10ge(4).

Add uart(4).

MFC after: 3 days

Autogenerate hardware notes for the ce(4) driver.

Remove sound since the sound(4) manual page no longer have a
HARDWARE section.

Reviewed by: brueffer

ti(4) also works on sparc64 now.

bge(4) is working on sparc64 now.

Autogenerate hardware notes for snd_atiixp(4).

Apply arch= selection to the qandatoc mode. This fixes
link generation with no actual target.

Reported by: Tim Witthoeft (tim.witthoeft at gmail.com)

em(4) works on all archs now, so this can be removed.

snd_es137x now works on sparc64.

Autogenerate hardware notes for snd_mss(4).

Add esp(4).

MFC after: 3 days

Add cdce(4).

Reviewed by: brueffer

hptmv(4) now works on amd64.

Remove the el(4) device, which has been retired recently.

snd_via8233(4) works on amd64.

Approved by: brueffer (mentor)

Auto generate device listings for snd_t4dwave(4).

Approved by: brueffer (mentor)

Update version numbers to 7-CURRENT.

Handle .Li macro's with quoted arguments, which is used in the ath(4)
manual page.

Noticed by: brueffer (long ago)
Approved by: re (hrs)

- Autogenerate device listings for sound(4) aka pcm(4)
- Rename the Audio Devices section into Sound Devices, this is more
in line with out sound and snd_* drivers

MFC after: 1 week

Add nve(4).

Use smart quote entities instead of double ``ticks'' to create more
aesthetically pleasing HTML output.

Tested with: mozilla, opera, lynx, links
Problematic with: w3m
Reviewed by: remko, keramida

Autogenerate hardware notes for snd_als4000.4, snd_fm801.4 and snd_via8233.4.

Bump &release.manpath.netbsd;.

Autogenerate device listings for arcmsr(4).

When building release documentation for release builds or for
release documentation snapshots, force URLS_ABSOLUTE. This
allows us to relocate HTML renderings anywhere without worrying
about breaking relative links to pages on the Web site. This can
happen when we use &base; as part of a URL.

I wonder if we should do this for all release documentation builds,
but I'm not quite sure what all the cases are.

Rather than pointing users at jp.freebsd.org for CURRENT
snapshots, instead point them at a Web page on the main FreeBSD
site that gives more information on the monthly (RE-created) snapshots
plus pointers to the jp.freebsd.org and se.freebsd.org snapshots.

Autogenerate device listings for sr(4) and rc(4).

MFC after: 3 days

- Fix device names for snd_vibes(4) and snd_via82c686(4).
- Bump copyright year.

MFC after: 3 days

- Auto generate device listings for snd_vibes(4) and snd_via82c686(4).
- Sort dev.archlist.txt.

- Auto generate device listing for snd_neomagic(4).

MFC after: 3 days

Autogenerate device listings for snd_sbc(4).

MFC after: 3 days

Add oltr(4)

Autogenerate device listings for bktr(4).

MFC after: 1 week

Autogenerate device listings for umass(4).

MFC after: 3 days

Autogenerate device listings for ng_bt3c(4).

MFC after: 3 days

- Auto generate device listings for the pst(4) and vpo(4) device
drivers.

MFC after: 1 week

Auto generate device listings for the snd_maestro(4) and snd_maestro4(4)
device drivers.

MFC after: 1 week

Add snd_audiocs(4).

- Update usage to reflect the current reality.
- Fix a bug where manual pages which had a "_" in their name did not
get proper architecture setting.

MFC after: 1 week

Auto generate device listings for the snd_ich(4) driver.

MFC after: 1 week

Add hptmv(4)

gx(4) is gone, remove any references

Bump &release.manpath.netbsd; to 1.6.2.

Add ulpt(4) and urio(4).

MFC after: 3 days

cnw (Xircom pccard) is built on amd64 and there isn't an obvious reason
that I can see as to why it shouldn't work.

Auto generate device listings for the snd_ess(4) driver.

MFC after: 3 days

Since early-adopter has been disconnected from the build, don't try
to install it to a RELNOTESng snapshot.

Add ed(4)

MFC after: 3 days

Add cnw(4)

MFC after: 3 days

Add lnc(4), ng_ubt(4) and pcn(4), firewire works on ia64

MFC after: 3 days

- note ia64 support for several drivers
- remove drivers that work on all supported architectures

MFC after: 3 days

Add fwohci, hifn, safe, sbp, and ubsec.

MFC after: 3 days

- Auto generate device listing for the uvisor driver.

MFC after: 3 days

Remove duplicate entries for ubsa(4), uftdi(4), and uplcom(4).

Noticed by: brueffer
Pointy hat to: simon

Add gx(4)

Add em(4)

Add ubsa(4), ubser(4), uftdi(4), and uplcom(4).

MFC after: 3 days

- Add snd_csa(4) and snd_gusc(4).

nge(4) works on alpha as well

MFC after: 3 days

Make a warning less cryptic.

Add vge(4) to the Hardware Notes.

Add uvscom(4)

Add ucycom(4)

Auto generate device listing for the uhci driver.

MFC after: 3 days

Auto generate device listings for the following drivers: cp and ctau.

MFC after: 3 days

- Add &release.manpath.xorg;.
- Bump &release.manpath.xfree86;.

Add el(4), ep(4) and sn(4)

MFC after: 3 days

Add re(4) and sis(4)

MFC after: 3 days

- Auto generate device listings for the ex and ie drivers.

MFC after: 3 days

Make sure ampersand is encoded as &amp; since jade seems to be confused
when it is encoded as &#38; inside an entity.

MFC after: 3 days

Add snc(4)

MFC after: 3 days

Add ubsa(4), uftdi(4), uplcom(4) and wb(4)

MFC after: 3 days

Add ti(4) and tl(4)

MFC after: 3 days

Add nge(4) and ste(4)

MFC after: 3 days

Trim errata and bump &release.next;.

aac works in ia64, twe and twa seem to work on amd64 (though not officially
supported by 3ware)

MFC after: 3 days

- Auto generate device listings for the following drivers: snd_ad1816,
snd_cmi, snd_cs4281, snd_ds1, snd_emu10k1, snd_es137x, and snd_solo.

MFC after: 5 days

- Improve handling of trailing punctuation characters for the Xr macro.

MFC after: 3 days

- Auto generate device listing for ath(4).

MFC after: 3 days

- For column lists: ignore first item when it is likely to be a header.
- Clean up and improve handling of trailing punctuation characters.
- Handle the Pa macro.
- Give a warning when ignoring unimplemented mdoc commands.

MFC after: 3 days

s/_/./g for an entity name.

Reviewed by: simon

Add cue(4) and kue(4)

Support column lists, by only extracting the first column.

MFC after: 3 days

Add axe(4) and rue(4)

Add lge(4) and vx(4)

asr(4) is currently i386 only.

Confirmed by: scottl
MFC after: 2 days

Add sk(4)

Add sf(4)

Add ixgb, remove isp and mpt (work on all supported platforms)

Bump version numbers for 6.0-CURRENT and fix some sentences.

- Remove note about device listings going away.
- Add a note about possibility for duplicate listing of devices.
- Auto generate device listings for the following drivers: ncr, sym,
umodem, and uscanner

MFC after: 3 days

- Handle the '\&' mdoc(7) escape sequence.
- Handle the .Sx macro and give a warning if it is used in the
HARDWARE section, since that will probably produce odd text in the
Hardware Notes.

- Auto generate device listings for the following drivers: mpt, trm,
rl, vr, dc, de, and gem.
- hme(4) is not sparc64 only anymore, so update dev.archlist.txt
acordingly.

Auto generate device listings the following drivers: mlx, mly, and ncv.

Add twa(4) to the Hardware Notes.

Auto generate device listings the following drivers: adv, amd, bt, ida,
iir, ips, nsp, ohci, and stg.

- Add support for the .Dq macro.

- Add an -o option to specify the output file.
- Make "die()" more verbose.
- Do not put extra blank lines into the output file.
- Normalize text by using numeric entities because
some characters such as "'" can break the generated SGML.

Reviewed by: simon

Auto generate the device listings in the Hardware Notes based on
manual pages, to avoid duplicating work between the Hardware Notes and
manual pages.

Each text line in the output from the manual page parser is generated
as a SGML entity, making it possible for translators to only translate
lines which actually contains English text (this neat idea came from
hrs).

To determine which drivers are usable on which architectures the
dev.archlist.txt file is used to explicitly list this. It it an
imperfect solution, but the best I have been able to come up with for
now.

This commit converts most of the devices which has a section 4 manual
page with a HARDWARE section to be the new auto generated format.

Reviewed in principle by: ru, hrs, trhodes
Good ideas for improvements: hrs
No objections: -doc, re

Bump &release.prev; and &release.prev.stable;.

Switch manpath for FreeBSD manpages to 5.2-current.

Bump various entities for 5.2-CURRENT, trim release notes and errata.

Grrr...get the semantics of these entities right.

Approved by: re (implicitly)

Version number bump for 5.2-BETA release documentation.

Approved by: re (implicitly)

Bump the version numbers used for man page reference.

Commit amd64 MD release documentation stubs and hook up to the build.
Content will be filled in later as needed, but this should unbreak
the doc part of an amd64 release build.

Requested by: peter

Update release documentation version numbers for 5.1-CURRENT.
Trim release documentation and errata. While here, put back
some conditional text in the errata that was removed during
5.0-RELEASE and never put back.

Move ($create-refentry-xref-link$) to the language-neutral place
and add entities &release.manpath.*; for man.cgi's manpath=XXX.

Approved by: re (bmah)

Version number bump: We're at 5.1-BETA now.

Note that the previous commit message for this file should have read:
"4.8-RELEASE is the latest release from the 4-STABLE branch." [1]

Pointed out by: Stijn Hoop <stijn@win.tue.nl> [1]
Approved by re (implicitly)

4.8-RELEASE was the last release from the 4-STABLE branch.

Bump RELNOTESng version numbers for CURRENT in a post-5.0 world.

HEAD is 5.0-CURRENT again.

Version bump for 5.0-RC.

Approved by: re

Add ia64 documents to RELNOTESng snapshot.

Include the pc98 installation document in the RELNOTESng snapshot
page.

Hook up early-adopter article to RELNOTESng build.

Point -CURRENT seekers to a snapshot site that's actually up.

Provide a way to keep out old ("historic") release notes from bloating
the size of the rendered release notes. By default, any element with
a role="historic" attribute won't get rendered in the output unless
the INCLUDE_HISTORIC Makefile variable is defined.

pc98 now has its own relnotes and hardware documents.

Don't use graphics in callouts for the release documentation. The
little graphics images are a pain to deal with, and they don't work in
the *.TXT files anyways.

Submitted by: ue

Add a new entity for the previous stable release. For the most part,
the release notes compare 5.0-CURRENT to 4.0-RELEASE, but in at least
one place it is beneficial to mention the last stable release of
FreeBSD (4.5-RELEASE).

Reviewed by: bmah

Activate the sparc64 installation document.

Put URL references in footnotes (rather than in parentheses following
the link text), and put footnotes at the bottom of each page. This
change affects the release documentation only.

Support a comma-separated list of architectures for the arch=
attribute. This change is necessary in order for the release
documentation to scale to support more than two architectures.

Based on work by: hrs

New release notes: bge(4), ng_gif(4), ng_gif_demux(4), ng_ip_input(4),
tftpd(8) support for RFC 2349.

Add a sample Makefile as an example of building RELNOTESng for
the release documentation snapshot page.

More README file cleanup, mostly for style. Also punt the readers
to the Handbook for more documentation sources. Mention INSTALL.TXT
as one of the other release documentation files.

Language-dependent catalogs for RELNOTESng should override
the language-independent catalog.

Tested by: Alex Kapranoff <kapr@acm.org>

Better support for multi-lingual release documentation. We now support
language-dependant SGML catalogs (in ${LANG_CODE}/share/sgml) and also
use a default.dsl stylesheet similar to what the rest of the DocProj
documents use.

Requested by: hrs, Alex Kapranoff <kapr@acm.org>
Reviewed by: hrs, dd
MFC after: 2 days

Back out 1.6->1.7 change; this wasn't supposed to get committed.

New release notes: lpd(8) -c and -w, lpc(8) tclean, whois(1) recursive
lookups, moused(8) -a, binutils 2.11.2.

MFCs noted: IPv6 update.

Change the way the value of DESTDIR is determined for the release
notes build. Instead of having doc.relnotes.mk make a guess, hardcode
quite a bit (but as little as possible) in Makefile.inc's sprinkled
strategicly throughout the tree. This has the advantage of actually
working properly (which is a Good Thing(tm)), and the disadvantages of
more files in the repository and more hardcoded paths (which are both
Bad Things(tm)).

Don't hardcode in "/release/doc/"; instead, make it the default of a
new RELN_ANCHOR variable. It may be necessary to override this if the
path to the checked out release notes tree doesn't end with
"release/doc".

ISO_* -> ISO* rename

"$FreeBSD $" -> "$FreeBSD$" (the space causes CVS to think this isn't
a keyword, so it wasn't expanding it)

In some cases, there are some <sect1></sect1> elements that will have
version control information that is different from the rest of their
containing document (or at least other sections). For release notes
only, allow output of <sect1info><pubdate></pubdate></sect1info>
text, and add it to three sections of RELNOTESng where it's kind of
important ("What's New" in the release notes, "Supported Device" in
the arch-independent hardware list, and the processors section of the
alpha hardware list).

More RELNOTESng infrastructure fixup: The directory layout of
stylesheets (particularly with respect to translations) is now similar
to that of the doc/ tree. Added a customization for HTML page footers
(this is the only reader-visible change).

RELNOTESng infrastructure fixes:

1. There is now only one RELNOTESng stylesheet; the architecture-specific
stylesheets (to handle different values of the arch= attribute) are gone.

2. Several Makefile variable definitions were factored into
doc.relnotes.mk.

Submitted by: dd

Build system:
o Define a RELN_ROOT variable which points to the root of the relnotes
tree (i.e., src/release/doc).
o By default, define DOC_PREFIX in terms of RELN_ROOT; this gives a
bigger chance of finding the doc/ tree without help in the form of
setting DOC_PREFIX on the command line.
o Respect DOCDIR; `make install` works now.

Approved by: bmah

First commit of RELNOTESng, the rewrite of the *.TXT documentation
files.

src/release/doc/README has additional information.

Reviewed by: -current, -doc