Commit graph

184 commits

Author SHA1 Message Date
reed
1f98aed935 Remove indentation of second line of example I just committed. 2005-09-14 16:40:57 +00:00
reed
da241b947d In the "converting packages to use buildlink" section,
mention setting BUILDLINK_DEPENDS.foo.
(Suggested by Steven M. Bellovin on tech-pkg.)
2005-09-14 15:55:35 +00:00
rillig
8ba088c4d6 Various fixes for typos and grammar by Leonard Schmidt. 2005-09-02 19:12:37 +00:00
cube
145d1272e0 Fix bogus variable names in the options framework example.
From Aron Stansvik.
2005-08-29 22:43:11 +00:00
reed
ad5d7e6eb5 Fix typo noted by Richard Rauch on tech-pkg. 2005-08-10 05:27:56 +00:00
gdt
ef176f1a7a In components, in patches section, add admonition to send patches that
are really fixes upstream.  (Prompted by note back from an upstream
maintainer after sending him someone else's bugfix patch that he
hadn't already gotten asking me to make sure upstream maintainers get
patches.)
2005-08-04 17:38:06 +00:00
wiz
9af4673c11 Fix some XML errors I introduced. Noted by rpaulo@. 2005-08-03 16:34:19 +00:00
wiz
e6d1adaa51 Do not document obsolete IGNORE variable any longer. 2005-07-28 11:05:36 +00:00
wiz
2f3fca00e2 Document some more variables. 2005-07-28 11:05:35 +00:00
rpaulo
8489107798 Sync htdocs tarball with htdocs as of today. 2005-07-27 21:33:36 +00:00
rpaulo
6e5fb2dbec Replace <pkg> by <filename role="pkg"> as discussed on netbsd-docs@.
ok hubertf@
2005-07-27 21:29:50 +00:00
gdt
97882e306a rewrite license section:
State explicit policy for which licenses do not require tags (Open
  Source or Free).
  Give pointer to RESTRICTED, NO_BIN_ON_CDROM, etc. as a separate issue.
  Change example; graphviz is now Open Source and does not set LICENSE.
  Deprecate "shareware" etc.
  Remove explanation of how to bypass license mechanism.

(discussed with wiz, reviewed by hubert and reed)
2005-07-27 14:40:46 +00:00
wiz
9158e7670c Indent. 2005-07-26 17:29:13 +00:00
dillo
7b2c274c13 document PKG_OPTIONS_NONEMPTY_SETS 2005-07-26 09:37:50 +00:00
wiz
6a8dcc3c92 No leading or trailing whitespace in <para>. 2005-07-16 19:21:50 +00:00
wiz
6def4f4796 audio/realplayer moved to multimedia/realplayer.
Noted by Geert Hendrickx in PR 30543.
2005-06-17 12:55:25 +00:00
dillo
c360872d9f Fix capitalization of section heading.
Add comments with suggested contents from jmmv's original mail.
2005-06-11 16:31:40 +00:00
dillo
1708023c36 Update to new handling of no supported options.
Remove commented out user-level documentation.
2005-06-11 16:31:03 +00:00
dillo
bb6b79a875 in do-lint, invoke make with the MAKE_ENV set. Makes it work with
LOCALBASE != /usr/pkg.
2005-06-11 16:26:47 +00:00
wiz
e76a5b413c Mention what happens with vulnerable binary packages. 2005-06-09 18:33:30 +00:00
wiz
56f0eded4e Improve section on handling packages with security problems. 2005-06-09 18:30:33 +00:00
wiz
7c7c2c66f4 Add a new section describing what to do when changing packages.
(points to pkgsrc/doc/CHANGES and pkgsrc/doc/TODO, and describes
the changes-entry target).
2005-06-08 23:03:49 +00:00
dillo
f52b47b539 fix variable name in example 2005-06-08 16:20:17 +00:00
dillo
baa0eafe30 Add chapter about configuring pkgsrc, as proposed on tech-pkg by jmmv, and
fill in section about options framework.
2005-06-08 13:59:30 +00:00
dillo
6a0b204c98 update developer documentation for options framework (writing
packages that use it)

XXX: user documentation (selecting options) still missing
2005-06-07 20:01:04 +00:00
wiz
244ab4a685 Fix typo reported by ISIHARA Takanori in PR 30436. 2005-06-05 23:14:33 +00:00
reed
34af7f3ee5 Document IGNORE_RECOMMENDED=YES. This includes sentences from tv@
that I read on tech-pkg@.
2005-06-03 16:09:11 +00:00
reed
62b88473cc Remove link back to this same documentation. 2005-06-03 16:05:30 +00:00
dillo
ae976b8c5c remove leading white space and reformat
remove whitespace around tags
2005-06-03 13:29:18 +00:00
jmmv
d2a604d8a4 Cut long line and refill paragraph. 2005-06-03 13:05:20 +00:00
wiz
4040eb5354 Some improvements 2005-06-03 12:54:11 +00:00
jmmv
6e1112e58c Add a new chapter describing the pkginstall framework.
As a side effect, a question in the FAQ is simplified and several sections
from the "fixes" chapter are removed.
2005-06-03 12:27:48 +00:00
jlam
915b420546 Update to reflect using the tools framework to show the need to run
autoconf and automake.
2005-06-01 22:49:59 +00:00
wiz
0d467b92d1 Update guide for USE_X11 -> x11.buildlink3.mk change. 2005-06-01 20:58:16 +00:00
jmmv
ef81bfd6ab Reformat:
- Cut long lines wherever possible.
- Remove indentation of major sections (chapter and sections).
- Remove spaces between tags and CDATA (as in '<para>foo</para>').
- Some other minor fixes.
2005-06-01 15:49:44 +00:00
wiz
5ec26f9af0 Fix a typo and remove some superfluous whitespace. 2005-05-31 16:55:19 +00:00
jmmv
1fd81d6b9a Change the 'non-root builds' question to reflect recent changes (existence
of the UNPRIVILEGED variable and simplification of bootstrapping).
2005-05-29 17:16:28 +00:00
wiz
6e53729b8b Update section on what to do when distfiles change. 2005-05-29 09:10:40 +00:00
wiz
c436445ae4 Document where documentation should be installed. 2005-05-26 16:32:42 +00:00
wiz
f85708c219 Add an id to <book>, thus removing all automatic id[0-9]* ids from the guide. 2005-05-24 12:39:00 +00:00
wiz
5fc33803c9 Add an id to all sect[123]. 2005-05-24 12:14:42 +00:00
rillig
67b88d7bfd Replaced obsoleted USE_GNU_TOOLS with USE_TOOLS. 2005-05-24 11:11:24 +00:00
rillig
1e94e06569 Updated the documentation on the PKG_OPTIONS framework. 2005-05-20 10:02:03 +00:00
rillig
c39fdc1cf4 All list variables should have ``plural'' names, e.g. PKG_OPTIONS or
DISTFILES.
2005-05-16 09:27:48 +00:00
rillig
b513806977 Added documentation for a bug in bmake, and a reference to the package
regress/make-quoting, where a more complete example and a workaround is
presented.
2005-05-15 23:46:20 +00:00
rillig
0cab38e9c4 Fixed some typos. Using uppercase names for variable parts of PKG_PATH.
Added /usr/pkg/sbin to the list of directories in which tools can be
installed.
2005-05-15 20:38:40 +00:00
rillig
b976222af8 Fixed some typos. 2005-05-15 20:33:01 +00:00
rillig
c23e8ee5f8 Moved the makefile section after the components section, which makes much
more sense.
2005-05-15 20:32:27 +00:00
rillig
0390e4d07f Using <command> instead of <varname> to quote the .for loops. 2005-05-15 20:31:45 +00:00
rillig
2b43f50777 Changed "bootstrap" to "bootstrapped". Changed &uprompt; to &cprompt;,
as this makes more sense.
2005-05-15 20:30:54 +00:00
rillig
ef412aba53 Removed the sentence that states ftp.netbsd.org has cvs binaries for
various platforms.
2005-05-15 20:28:15 +00:00
rillig
ea81d06c03 Changed the wording of some package descriptions. Removed unnecessary code
from the wget example.
2005-05-15 20:27:15 +00:00
rillig
9b4ea139b2 Updated list of MASTER_SITES. 2005-05-15 20:24:17 +00:00
rillig
f9084b57c0 Added a restriction that PKGNAME must match ^[A-Za-z0-9][A-Za-z0-9-_.+]*$.
The only current package that does not match this restriction is
x11/kde3-i18n-sr_Latn.
2005-05-15 02:57:33 +00:00
rillig
40fa53ab96 Applied the "detab" tab->space conversion. 2005-05-14 22:34:59 +00:00
rillig
34a68c8667 Added a "detab" target that replaces <tab> characters inside the
<programlisting> tag with an appropriate number of space characters.
This is needed for TeX.
2005-05-14 22:33:27 +00:00
rillig
3ce24f9a87 Applied the quoting rules to my own examples. "Converting an internal
list to an external list" had been wrong.
2005-05-14 03:30:56 +00:00
rillig
a84e59e2b1 Replaced a "." in an example with "foo", which is better distinguishable
from the end of the sentence, which also is a dot.
2005-05-14 03:26:09 +00:00
rillig
a4df11476f Added a subsection called "Quoting guideline", which describes some of the
common quoting errors.
2005-05-14 03:23:20 +00:00
rillig
167f28256e Added a subsection about naming conventions for Makefile variables. 2005-05-13 23:28:08 +00:00
rillig
c8b01f08a6 Added a comment describing from which files I extracted the information I
needed for this documentation.
2005-05-13 22:48:09 +00:00
rillig
25ca0bb461 Minor spelling and wording fixes. 2005-05-11 21:29:13 +00:00
rillig
419b675134 Documented the (inconsistent) behavior of .for loops. Renamed ``atoms'' to
``strings''. Removed trailing whitespace.
2005-05-11 21:19:45 +00:00
rillig
99892aa7b1 Fixed the paragraphs that documented the quoting mechanisms. They had been
horribly incorrect.
2005-05-11 20:53:27 +00:00
wiz
5683ea907d Some fixes and minor improvements. 2005-05-10 22:41:10 +00:00
rillig
4b12963866 The make(1) man page is currently wrong, so don't make users take this
chapter too serious for now.
2005-05-10 01:15:54 +00:00
rillig
7c91d439ea Added first (still incomplete) version of the guide for programming with
Makefiles.
2005-05-10 00:27:43 +00:00
rillig
b2a7b1b96b Removed some lines from the example output of pkglint that don't appear
anymore.
2005-05-10 00:05:03 +00:00
wiz
5a2e7a9c43 Use more man page entities, now that we have them. 2005-05-08 13:53:06 +00:00
wiz
70eff6e059 Document that the upload script takes care of vulnerable
and restricted packages automatically.
Use more man page entities, now that we have them.
2005-05-08 13:52:17 +00:00
wiz
8c9c133a9a Sync htdocs tarball with htdocs contents of today.
With lots of help from hrs@.
2005-05-07 22:40:25 +00:00
wiz
780c67da25 Remove references to Packages.txt. 2005-05-07 22:28:47 +00:00
wiz
56b6acd261 Use sh(1) instead of &man.sh.1;, which does not work yet. 2005-05-07 22:28:15 +00:00
wiz
5b3329a65d Fix previous: paragraph should end after last letters. 2005-05-07 15:35:11 +00:00
rillig
081173559c Restructured the description of the first two sections of the package
Makefile. Fixed some other typos. Removed the MESSAGE file of audit-
package and described how to display it. Approved by wiz.
2005-05-07 15:28:40 +00:00
wiz
fdfee6342b Fix typo. 2005-05-06 23:28:50 +00:00
wiz
c65974aca0 Some minor fixes while I was browsing. 2005-05-06 23:04:16 +00:00
wiz
9819c3f6a4 Mention that semicolon is a shell meta-character and that it probably
needs quoting in the PKG_PATH, to avoid user confusion.
Reviewed by dillo.
2005-05-06 21:24:21 +00:00
wiz
bab2761322 Fix a typo. Document PKG_PATH. Document vulnerable/ directory.
Reviewed by dillo, rillig, salo.
2005-05-06 00:46:43 +00:00
wiz
0d1b5425cf Fix another section about .la files in PLIST
XXX: someone, please regen.
2005-04-17 09:38:26 +00:00
tv
66df6ed634 Remove reference to USE_BUILDLINK3. 2005-04-12 16:13:27 +00:00
tv
f816d81489 Remove USE_BUILDLINK3 and NO_BUILDLINK; these are no longer used. 2005-04-11 21:44:48 +00:00
reed
e5bea7bd0a Use &man.make.1; instead of make(1) and fix typo where example
for LOCALBASE said DISTFILES.
This is from Kibum Han in PR pkg/29940.
2005-04-11 16:38:21 +00:00
jschauma
654a1a7092 Don't use &mdash; -- this doesn't seem to know about it.
Import README.Linux
2005-04-10 22:45:25 +00:00
jschauma
cd43ff47b3 synch with last changes to bootstrap and READMEs 2005-04-10 22:21:54 +00:00
ben
97aa048201 Update for recent changes of the default value of PLIST_SRC.
This addresses PR#29569
2005-03-24 05:05:34 +00:00
ben
0649f41999 Remove paragraph that suggests that if PLIST.${OPSYS} exists, it will be
used instead of PLIST.

If PLIST exists, it is unconditionally used in addition to PLIST.${OPSYS}.

This addresses PR#29740
2005-03-24 04:50:08 +00:00
wiz
9299fca513 Add RMD160 checksum. 2005-03-22 17:21:03 +00:00
tv
dbe3df7937 Document a .termcap string usable for Interix console windows. 2005-03-21 21:40:28 +00:00
wiz
0afb1a08e5 Document which libtool files should be added to the PLIST.
Closes PR 29570.
2005-03-17 15:11:23 +00:00
xtraeme
5f64cf41d9 fixes.xml:
Added section 12.5.18: "Packages installing startup scripts".

editing.xml:

Fix typo, the target is "install-htdocs" not "install-htdoc".
2005-03-08 01:22:41 +00:00
jschauma
7ed83179e3 Add some more mailing lists. 2005-02-24 14:24:32 +00:00
grant
2c9e7c0405 s/recognise/recognize/. TNP uses American English. 2005-02-10 13:39:15 +00:00
sketch
f9262179a7 Fix typo. 2005-02-10 11:26:00 +00:00
reed
94c8ce7c69 Remove unknown extra word "agail". 2005-02-04 21:06:38 +00:00
jschauma
b78505795f document MKSUMS and SIGN_AS for checksum files of a bulk build 2005-01-24 14:44:39 +00:00
heinz
b934a01a89 Correct spelling of NetBSD.org.
Beware of the long reach of the HTML police!
2005-01-18 23:25:04 +00:00
grant
3876d3a375 mention Tru64 support. also mention DragonFlyBSD in platforms. 2005-01-16 02:31:33 +00:00
wiz
bd80548a66 Improve resume section, and use complete path for /etc/mk.conf in two places. 2005-01-11 16:05:20 +00:00
xtraeme
7cb00d0f37 Added section 6.5: "How to resume transferencies with pkgsrc?", while
here fix a typos in the XFree86/X.org sections.
2005-01-11 15:47:00 +00:00