There is still some debate if this is yet the proper way to handle
<sys/param.h>, but this is certainly closer than what I had to start with.
Submitted by: Warner Losh <imp@village.org>
sys/param.h. Change _HAVE_PARAM_H to "HAVE_SYS_PARAM_H" for those who
still like this method -- leading underscores are in the compiler/library
name space and the Ollivier says to follow GNU Autoconf anyway.
This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.
Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.
"+=" originally because (as I understand) Jordan used a sed script (or
was it perl?) to edit all the ports Makefiles automatically and he
wanted to make sure multiple CATEGORIES lines (they were inserted
after DISTNAME or something, there shouldn't have been multiple of
them to begin with but that's another story) won't be stepping on each
other's toes.
Reminded by: obrien
^^^^ ^^^^^
doesn't make the ".." in typewritten format. And the ascii version
of the file shows '<tt>..</tt>' literally. After looking into linuxdoc dtd,
we found there is no way to make ".." in typewritten font.
Noticed by: Mitsuru IWASAKI <iwasaki@pc.jaring.my>
Added reference to "MAINTAINER on Makefiles" section.
Added reference to pkg_create(1) man page in the explanation of the packing
list.
Added description of ${INSTALL_*} macros.
Added an explanation to use patch files distributed in .tar.gz format.
Added statement about the copyright on the submitted files.
Slgith change in sample Makefile.
Written mostly by: asami
substitute.
(2) Bring the *_DEPENDS section up to the current state. Explain that
the pathname in the "path:dir" pair can be a full pathname if you
want a port to depend on something that isn't executable or an
executable that's not expected to be in the user's search path
(like /usr/local/libexec). Also, change the LIB_DEPENDS example
to use jpeg, tcl-7.3's appropriateness as an example is quite
outdated at this point. ;)
(1) Additional __FreeBSD_version's from <osreldate.h>. Closes PR
docs/1438.
Submitted by: "David E. O'Brien" <obrien@Nuxi.cs.ucdavis.edu>
(2) Make it clear that when submitting a port, the package is not
necassary.
Suggested by: joerg
(3) Recommend people to use send-pr to send us notifications of new
ports and upgrades so that they won't fall between the cracks.
Suggested by: a lot of people
(4) Add a section about Motif and describe REQUIRES_MOTIF and
MOTIFLIB.
Prodded by: chuckr
(5) Revise the licensing problems section and describe the two
variables RESTRICTED and NO_CDROM.
(6) Fill in the section about upgrading. In particular, recommend to
send in diffs of the old and new ports (these are "ports", not the
original source or anything!), so it's easier to see what has
changed.
I was in the middle of one of these "projects" when I started
on the next, so they wound up all intermixed)
Move the mailing list entities from authors.sgml to the new file
lists.sgml. Add an entity for majordomo at the same time.
Avoid the use of contractions. This revealed some grammer problems,
and also has the benefit of helping make things clearer for those people
who do make speak English as a their first language.
we are consistent in how they are referenced in the handbook, and
so that they are now all clickable URLs. E.g. no more mis-matched
freebsd-hackers@freebsd.org and hackers@freebsd.org. They are used
just like the individual mail addresses defined in authors.sgml.
E.g. &a.doc will expand to:
FreeBSD documentation project mailing list <freebsd-doc@FreeBSD.ORG>
Be consistent in using the FreeBSD.ORG address. All references
to freebsd.org were changed to FreeBSD.ORG.
Use pre-defined addresses for some individuals where available.
