There is a two year old warning that this document is partly outdated
and that re@ is working on updating it.
I don't see many substantive commits updating this doc, so just do a
drive-by and remove the obviously wrong and outdated things.
- sysinstall has been replaced (and so scripting it is meaningless)
- cross building is possible
- drop support for disk2 and on
- remove empty sections, such as the one on cd-rom replication
- combine the 'how to contribute' doc and the 'contributing to ports' doc.
- modernize the 'contributing to ports' doc
- use &os;
- prefer poudriere to tinderbox
Reviewed by: crees, bapt, mat
No objections from: bdrewery, gavin, wblock
- remove article about releng packages
- we no longer produce multi-cd releases
- CVS is not our VCS system
- we havn't releaseed with xfree86 is years
- section 1 about the 'ports cluster' is now entirely untrue and
been disclaimed by portmgr
Discussed with: peter, bdrewery, Daniel O'Connor
- references mostly outdated hardware
- doesn't use modern technologies (IPMI, nmdm, bhyve)
- the SUN hardware peculiarities are not useful anymore
- there are other better references on crimping custom serial cables
- MAKEDEV is no a thing anymore
there might be room for a modern version of this article in the handbook
but there is little that is salvageable from this article.
Discussed with: bcr, xmj, sbruno, cem
- using a custom gcc should be done within poudriere
- there is a framework for choosing a ports compiler anyways
- this article is incomplete w.r.t. modern gcc verisons
- encouraging people to add global options like `mssse3` is dangerous
- the original reason to use a custom gcc is gone (our old gcc was
outdated)
- WITH_ and WITHOUT_ are outdated
- make.conf is the wrong place for modern systems (which should be using
poudriere)
- only reference package installation. Ports users can use the port name and
the normal ports documentation
There are a few places in the source tree where we list supported
architectures. Point people to a single place since we never remember
to update all the lists
- comparing 'Linux' vs 'FreeBSD' is comparing apples and fruit: one is
just the kernel and the other is a specific distribution.
- the license 'debate' is well covered elsewhere
- it still references CVS
- comparing the development style of '300 committers' vs 'going through
the maintainer' is a straw man and doesn't reflect how Linux works (or
how BSD works)
- the supported platforms list is old and incorrect
- the "Extensible Frameworks" section belongs elsewhere
- the 'security' section is a feature list, not a comparison and is
missing important features
etc.
Discussed with: mjg
it seems unlikely that users new to FreeBSD will want to do any of
- use a floppy
- use DOS
and even using a tape drive and printing aren't common first tasks
remove this section
- move perks into a question rather than its own section
- stop directing people to email me directly and instead direct people
to email the liasion alias
- it references sysinstall, which is gone
- the scripts used to install the system use pkg_add not pkg
- and are rotted in other ways
- the limitations of sysinstall have been somewhat mitigated by
bsdinstall (which can install into a new directory)
- it warns of outdated stuff (acroread8 doesn't exist anymore)
- package building takes place on runnning system and not on poudriere
- many of the packages referenced don't exist or are vastly changed
- it incorrectly installs the base system
- and more
Discussed with: jmg, Daniel O'Connor, bjk
- laptops do not come with PCMCIA anymore
- laptops don't come with modems anymore
- APM is dead
- ACPI power management is in the handbook
- pccard is dead
Discussed with: jmg
- use pkg instead of directly installing from ports
- reduce references to old versions of gcc, and make the article more
future-proof
- now that we either have a modern version of gcc or clang in base / as
the package building compiler, the impact of binary perf is no longer
relevant.
really, this article should either move into the handbook or be removed.
Finish the job of r45149 and remove reference to now undocumented 'better
features' of CVS.
Remove note about difference between location of www repo between CVS
and SVN: we switched long enough ago now that it doesn't matter.
Remove additional comparisons to CVS which likely don't matter to committers
anymore.
Add a bit about how to request and apply merge to the ports' quarterly branches.
Differential Revision: https://reviews.freebsd.org/D2006
Approved by: wblock
Sponsored by: Absolight
