doc/en_US.ISO8859-1/books/developers-handbook, branch main

Migrate doc to Hugo/AsciiDoctor

2021-01-25T23:31:29+00:00

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 
Glen Barber 
Hiroki Sato 
Li-Wen Hsu 
Sean Chittenden 
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

books/: Address more instances of sentences beginning with 'Because...'

2021-01-12T18:33:23+00:00

As was the case with the previous commit, the intention is to avoid
sentence fragments as well as sentences that can be mistaken for them,
since the handbook isn't written in a style that makes use of
subordinate conjunctions.

While touching the relevant files, I also fixed a few issues pointed
out by PauAmma, and reflowed a sentence as a result.

PR:             252519
Submitted by:   ceri@
Reviewed by:    PauAmma

handbook: add a section on remote debugging via LLDB

2020-12-28T21:15:57+00:00

PR:		251709
Obtained from:	Moritz Systems
Submitted by:	Michał Górny 
Sponsored by:	The FreeBSD Foundation
Reviewed by:	bcr
Discussed with:	dim, emaste
Differential Revision:	https://reviews.freebsd.org/D27524

Remove a redundant sentence stop from a table entry

2020-07-24T18:15:05+00:00

for consistency.

Submitted by:	    kfv_irbug.org
Approved by:	    bcr
Differential Revision:	https://reviews.freebsd.org/D25786

Update the debugging section to include lldb as well.

2020-06-15T08:13:08+00:00

Clean up the sections a bit to distinguish the two available debuggers (gdb
and llvm).  This includes giving the existing gdb sections a title that
ends in "with gdb". The existing gdb section were grouped together into a
new "Using gdb" section and moved up one section level (sect3 to sect2).

A new section "Introduction to available debuggers" introduces and
distinguishes gbd and lldb. Insert a new "Using lldb" section after the
introduction, using the same structure and example code as the gdb section
to ease comparison between the two compilers.

An earlier reference to gdb is replaced by a generic debugger reference.
Include the neccessary whitespace changes. On top of that, update copyright
years of the developers-handbook.

Thanks to Pau Amma for his diligent work on the patch and incorporating
our feedback from the review!

Submitted by:	    pauamma_gundo.com
Reviewed by:	    debdrup, woodsb02, emaste, bcr
Approved by:	    bcr
Differential Revision:	https://reviews.freebsd.org/D25139

[website] Update projects section:

2020-05-02T09:03:18+00:00

Removed busdma and netpert projects from the website and all of the
references to their pages.

Reviewed by:	imp@, bcr@
Differential Revision:	https://reviews.freebsd.org/D24619

[website] Update projects section:

2020-05-02T08:51:58+00:00

Removed busdma and netpert projects from the website and all of the
references to their pages.

Reviewed by:	imp@, bcr@
Differential Revision:	https://reviews.freebsd.org/D24619

fiathd(8) and faith(4) were removed in r274331. Catch up to src and

2020-04-20T14:14:06+00:00

remove their documentation in the developers handbook.

Reviewed by:	bcr
Approved by:	bcr
Differential Revision:	https://reviews.freebsd.org/D24509

Use "^" refer to the base URL of the SVN repository.

2019-12-20T22:21:45+00:00

Subversion has supported this syntax for many years.

Reviewed by:	bcr
Differential Revision:	https://reviews.freebsd.org/D21949

Mass cleanup of textproc/igor warnings including:

2019-09-08T20:08:15+00:00

- use two spaces at sentence start
- space before content
- wrap long line
- start content on same line
- straggling 
- put listing on same line
- add blank line after  on previous line