Commit graph

82 commits

Author SHA1 Message Date
Masafumi Max NAKANE
77323ccb4e Added some guideline to write pkg/COMMENT.
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
1996-10-29 11:55:06 +00:00
Wolfram Schneider
2a0dcf6dc7 delete doubled words, e.g.: "the the" -> "the" 1996-10-05 18:36:22 +00:00
Wolfram Schneider
98bb0d639d a bunch of spelling errors 1996-10-04 22:54:17 +00:00
Satoshi Asami
4a76b8c496 Fix gaffe in comment. DISTNAME "v3.3beta021.src" corresponds to
PKGNAME "tiff-3.3", not "jpeg-5a".

Submitted by:	y-koga@ccs.mt.nec.co.jp
1996-09-12 05:00:53 +00:00
Satoshi Asami
f191a2fe1e Might as well update the date too, since so much has changed. 1996-08-28 06:40:49 +00:00
Satoshi Asami
34d7015c14 Bring this up to match reality. Also, fix dozens of small bogons I noticed
while translating this thing into Japanese.
1996-08-28 06:26:38 +00:00
Satoshi Asami
9408170cfd (1) Clarify the use of ${MOTIFLIB} by giving examples on what to
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. ;)
1996-08-20 09:51:02 +00:00
Satoshi Asami
fac1ac01ec Change ${NCFTP} to ${FETCH}. Fix bogon that describes the do-* targets
(it wasn't even English!).

Fixes PR docs/1448.
1996-08-01 00:12:11 +00:00
Satoshi Asami
b198d6d4d4 Add links to the sample Makefile from two other sections that talk
about Makefiles.
1996-07-30 22:19:42 +00:00
Satoshi Asami
fa0da7ab92 Bring this section up to reality.
(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.
1996-07-30 09:35:54 +00:00
Satoshi Asami
4ae1ad1fb7 Add comments on adding info about language specific ports and
compiled-in defaults to packages.  Closes PR docs/1439.

Submitted by:	"David E. O'Brien" <obrien@Nuxi.cs.ucdavis.edu> (some mods by me)
1996-07-30 05:51:14 +00:00
John Fieber
c44e9a49b7 Fix a couple things that tripped up latex output. 1996-05-24 19:33:33 +00:00
Mike Pritchard
b37985c476 (This really shouldn't all be on one commit, but I forgot
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.
1996-05-16 23:18:28 +00:00
Mike Pritchard
f6d864bf47 Add definitions for the various freebsd-* mailing lists so that
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.
1996-05-09 23:04:53 +00:00
Satoshi Asami
f12244be9e Describe usage of LOCALBASE and X11BASE in relation with PREFIX. 1996-04-10 06:32:42 +00:00
Satoshi Asami
2e30d691aa Fix typo. Closes PR docs/1099.
Submitted by:	Masafumi NAKANE <masafumi@tky007.tth.expo96.ad.jp>
1996-03-25 09:35:25 +00:00
Satoshi Asami
0bc74a1bc1 Add comment about DIST_SUBDIR. 1996-03-21 14:15:01 +00:00
Satoshi Asami
231aeb8885 Recommend installing additional port documents to ${PREFIX}/share/doc,
conditional to ${NOPORTDOCS} (commented out by default in /etc/make.conf).
1996-03-06 09:45:04 +00:00
Satoshi Asami
b4f0f90799 Remove reference to ${KEYWORDS}. 1996-03-06 09:04:43 +00:00
Mike Pritchard
43f5534015 Some more spelling fixes. 1996-01-31 14:26:20 +00:00
John Fieber
0a49c7d385 Add info about distinguishing freebsd versions.
Submitted by:	obrien@cs.ucdavis.edu
1996-01-28 16:36:24 +00:00
Jordan K. Hubbard
36c1a880e4 A number of misc changes, a revamp of chapter 17, place-holder for
new "project goals" document.
1995-12-07 13:22:18 +00:00
John Fieber
d0ed8938a4 Gobs of small tweaks and cleanups.
Submitted by:	Philippe Charnier <charnier@lirmm.fr>
1995-12-04 17:58:52 +00:00
Satoshi Asami
01c565cd41 Remove the part about recommending to put the version number in
pkg/DESCR.  As in COMMENT, it is not necessary, as we already have
it in ${PKGNAME}.
1995-12-04 08:11:58 +00:00
Satoshi Asami
2754fa3c80 contrib.sgml: Add my name to the "who's doing what" list.
porting.sgml: Update concerning the recent changes in pkg/COMMENT
              policy (no package name in front).
1995-11-14 23:58:43 +00:00
John Fieber
f56c1a6397 Two new sections:
* Kernel configuration, from Jake Hamby <jehamby@lightside.com>
    I'd like as many people as possible to give this one a good
    check before 2.1 goes out the door.

  * Routing, from Coranth Gryphon <gryphon@healer.com>

A bazillion formatting tweaks (only 13 bazillion more to go!)
1995-10-07 04:32:03 +00:00
Satoshi Asami
d4f50332c4 Updated description of *_DEPENDS. Changed "ldconfig" to "/sbin/ldconfig"
in examples.
1995-10-03 07:11:51 +00:00
Jean-Marc Zucconi
ee9ab1a5c7 Fix typos.
Reviewed by:	/usr/local/bin/ispell
1995-09-27 00:46:30 +00:00
John Fieber
cf6699b634 Placed a link to the XFree86 Project WWW pages as a placeholder for
our X11 documentation.

Vastly improved documentation for porting applications, courtesy of
asami@freebsd.org.

Submitted by:	asami@freebsd.org
1995-08-19 15:38:25 +00:00
John Fieber
396c73dcff Start populating the handbook with useful cross reference targets.
All cross reference labels start with name of the file that contains
them.  A label for the top section level is simply the name of the
file (omitting the .sgml).  Other references within the file append a
colon and onother name.  For example, the label on the mailing list
section in the file eresources.sgml is eresources:mail.  This gives
each file its own cross reference namespace.
1995-06-30 17:37:53 +00:00
John Fieber
9d509395d0 handbook.sgml
Rearranged a few sections, add memoryuse section.

current.sgml, ports.sgml, porting.sgml
  Added a <label>s for cross reference targes.

submitters.sgml
  Lots of editing, added cross references to other sections of
  the handbook.  Added a sample BSD-style copyright statement.

eresources.sgml
  Updated the mailing list section, thanks to Peter Dufault.

authors.sgml
  Added Peter Dufault, David Greenman and Joerg Wunsch.

memoryuse.sgml
  A new section about how/where in PC memory the FreeBSD kernel
  gets loaded and run.
1995-05-18 03:05:22 +00:00
John Fieber
4776451dac The FreeBSD handbook finds a new home. 1995-04-28 16:19:59 +00:00