Commit Graph

36 Commits

Author SHA1 Message Date
Masafumi Max NAKANE
c1582ceec0 Replaced `$' in the sample Makefiles with $.
Suggested by:	jfieber
1996-11-07 03:59:05 +00:00
Masafumi Max NAKANE
d3cf2d5d31 It's not too good idea to define nonexistent category in the sample Makefile.
(There used to be ``CATEGORIES+=printing''.)
1996-11-06 06:03:17 +00:00
Masafumi Max NAKANE
d20b02ebfa <ref id=** name="<tt>..</tt>">
^^^^  ^^^^^
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.
1996-11-05 09:42:59 +00:00
Masafumi Max NAKANE
e2e7a09936 In one place, bsd.port.mk was not enclosed in <tt></tt>.
Submitted by:	simokawa@sat.t.u-tokyo.ac.jp
1996-11-04 00:27:07 +00:00
Masafumi Max NAKANE
8a30663838 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
e627b39bac delete doubled words, e.g.: "the the" -> "the" 1996-10-05 18:37:31 +00:00
Wolfram Schneider
b6c00f9647 a bunch of spelling errors 1996-10-04 22:54:17 +00:00
Satoshi Asami
2623d3aa30 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
f0832b0f30 Might as well update the date too, since so much has changed. 1996-08-28 06:40:49 +00:00
Satoshi Asami
42883bed76 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
feef9138fd (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
a438b44b4a 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
520027e54c Add links to the sample Makefile from two other sections that talk
about Makefiles.
1996-07-30 22:19:42 +00:00
Satoshi Asami
3a45e50f39 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
6e6be3f445 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
5a38272bae Fix a couple things that tripped up latex output. 1996-05-24 19:33:33 +00:00
Mike Pritchard
09d44b1ef5 (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
239d617128 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
7ac319529f Describe usage of LOCALBASE and X11BASE in relation with PREFIX. 1996-04-10 06:32:42 +00:00
Satoshi Asami
2208fa01d9 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
816483bdd5 Add comment about DIST_SUBDIR. 1996-03-21 14:15:01 +00:00
Satoshi Asami
7041f8b545 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
26987878a0 Remove reference to ${KEYWORDS}. 1996-03-06 09:04:43 +00:00
Mike Pritchard
739d6a140c Some more spelling fixes. 1996-01-31 14:26:20 +00:00
John Fieber
63da77f219 Add info about distinguishing freebsd versions.
Submitted by:	obrien@cs.ucdavis.edu
1996-01-28 16:36:24 +00:00
Jordan K. Hubbard
89782ecebb 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
29397ffde5 Gobs of small tweaks and cleanups.
Submitted by:	Philippe Charnier <charnier@lirmm.fr>
1995-12-04 17:58:52 +00:00
Satoshi Asami
cb1a4c34b9 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
fc315fd89d 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
baf849c9b0 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
fa9d0501d1 Updated description of *_DEPENDS. Changed "ldconfig" to "/sbin/ldconfig"
in examples.
1995-10-03 07:11:51 +00:00
Jean-Marc Zucconi
d745bece54 Fix typos.
Reviewed by:	/usr/local/bin/ispell
1995-09-27 00:46:30 +00:00
John Fieber
e9328d1ba4 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
1e30867d53 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
84143d2611 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
dd8fd5aac1 The FreeBSD handbook finds a new home. 1995-04-28 16:19:59 +00:00