Commit graph

9 commits

Author SHA1 Message Date
Ceri Davies
a0f7ad455b Multiple files: Fix 'shared' references
The hier(7) man-page lists /usr/share as the location for
architecture-independent files, so fix a few instances where the
documentation referes to /usr/shared instead of /usr/share.

PR:		253760
2021-02-22 19:29:41 +01:00
Warner Losh
ea2dde38df Update shared library advice now that a.out no longer is a consideration
Remove old a.out information. Update the policy to match our current practice of
rarely, if ever, bumping the major version of libraries, but instead relying on
symbol versioning to maintain a stable ABI. Move from paragraph form to bullet
points. Also, tweak the 'once per major release' policy to 'as needed' because
the conditions that existed for the former no longer apply.

Discussed with: jhb@
Reviewed by: kib@, debdrub@
Differential Revision: https://reviews.freebsd.org/D28486
2021-02-08 17:04:05 -07:00
Warner Losh
e2223b82bd Minor wordsmithing to reflect current practice
Generally things are done by consensus, with the core team stepping in when
there's a dispute. Update the documented encumbered software policy to reflect
what's actually done and is considered to be working. This harmonizes the wording
for contributed software and encumbered software. Also wordsmith how Release
Engineering is referenced. Also removes stray > marks on object files. Also
document the fw files.

Note: the ascii file requierment dates from CVS days and should change. But
I've not pushed things that far in this commit.
2021-02-04 11:43:50 -07:00
Warner Losh
612d995019 More markup fixes
Get the sections rendering correctly in hugo
Convert markdown enumerated list convention to asciidoc
Remove stray '+' lines
Small tweak in wording missed in review for this content's new context
2021-02-04 11:21:34 -07:00
Warner Losh
4830802786 Fix minor markup issues with updating vendor import section 2021-02-04 10:49:28 -07:00
Warner Losh
e73763e350 Convert vendor imports to git instructions
Now that subversion is gone, replace the subversion info with git info.

Note: This was pulled in from my github repo. Fixes contributed
by jrm@, uqs@, woodsb02@, delphij@, rpokala@ and ceri@

Reviewed by: emaste@ (earlier version, conditional), gjb@
Differential Revision: https://reviews.freebsd.org/D28474
2021-02-04 10:36:08 -07:00
Warner Losh
e11aaf5a76 Revert "Convert vendor imports to git instructions"
This reverts commit 4fc73e884c.

4fc73e884c was pushed w/o review by mistake.
2021-02-03 17:43:45 -07:00
Warner Losh
4fc73e884c Convert vendor imports to git instructions 2021-02-03 17:40:30 -07:00
Sergio Carlavilla Delgado
989d921f5d Migrate doc to Hugo/AsciiDoctor
I'm very pleased to announce the release of
our new website and documentation using
the new toolchain with Hugo and AsciiDoctor.

To get more information about the new toolchain
please read the FreeBSD Documentation Project Primer[1],
Hugo docs[2] and AsciiDoctor docs[3].

Acknowledgment:
Benedict Reuschling <bcr@>
Glen Barber <gjb@>
Hiroki Sato <hrs@>
Li-Wen Hsu <lwhsu@>
Sean Chittenden <seanc@>
The FreeBSD Foundation

[1] https://docs.FreeBSD.org/en/books/fdp-primer/
[2] https://gohugo.io/documentation/
[3] https://docs.asciidoctor.org/home/

Approved by:    doceng, core
2021-01-26 00:31:29 +01:00