kpriv/pkgsrc
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
143217 commits 166 branches 0 tags 1.5 GiB
Commit graph

515 commits

Author SHA1 Message Date
ben
1378921fee Add a hint regarding set[ug]id pkgsrc programs on a Mac OS X disk image. 2006-08-29 00:29:52 +00:00
wiz
a2a32d1c64 Be more explicit about where devhelp can find its files. 
Document that we prefer share/doc/${PKGNAME} for docs.
 2006-08-12 21:29:40 +00:00
wiz
7bc27631a4 Typo fix. 2006-08-11 13:19:38 +00:00
wiz
63d40f1f8c Describe where gtk-doc docs used by devhelp should be installed. 
Based on text provided by drochner@
 2006-08-11 12:09:33 +00:00
wiz
982b974a7f Refer to firefox instead of mozilla. 2006-07-30 00:30:55 +00:00
wiz
289d1b9e39 Remove empty line. 2006-07-30 00:30:33 +00:00
rillig
43fca8b678 s/re-generate/regenerate/g 2006-07-29 17:55:13 +00:00
rillig
d55481d55e Moved all the pkgsrc documentation from outside the pkgsrc guide to 
here. There's still much to do to avoid repetition and such, but
the first steps are done.
 2006-07-29 15:57:04 +00:00
rillig
7e1b7fd9a3 Integrated the useful information from the NetBSD guide, chap-pack.xml, 
where the pkgsrc guide did not mention things before. Discarded the rest.
 2006-07-29 14:14:23 +00:00
rillig
162239966a Made the introduction more user-friendly. 2006-07-29 14:14:19 +00:00
rillig
05f3491592 Added the targets "regenerate", "regenerate-doc" and "regenerate-htdocs" 
to save some typing when updating the documentation.
 2006-07-27 07:06:13 +00:00
rillig
6ce05af35d Fixed a syntax error. 2006-07-27 06:40:05 +00:00
rillig
b6a5522945 The SunPro C++ compiler defines __SUNPRO_CC, but not __SUNPRO_C. 2006-07-27 06:39:10 +00:00
rillig
3e6a343422 Removed outdated documentation about SKIP_AUDIT_PACKAGES and 
ALLOW_VULNERABILITIES.*, as requested in PR 34096.
 2006-07-27 06:38:35 +00:00
rillig
4b92b6eecf Documented the current order in which files are loaded by the pkgsrc 
infrastructure.
 2006-07-24 12:13:35 +00:00
rillig
a91cd6f510 Moved the explanation of the various variables in the "fetch" phase from 
components.xml to build.xml. Added a list of variable names and a link
to the old place. Rewrote and extended the existing documentation to
cover most common cases.
 2006-07-24 10:32:36 +00:00
rillig
5f6028feac Added some sections on variable definition. 2006-07-23 15:48:01 +00:00
rillig
6e79d4a931 Rewrote the section on manual pages, avoiding to say everything twice. 2006-07-23 15:35:08 +00:00
rillig
256d2039b5 Shortened the description of where to find binary packages. 2006-07-23 15:34:10 +00:00
rillig
e21d06d9df Removed the chapter of the proposed redesign of the bulk build 
framework, since it did not contain any documentation on the current
system.
 2006-07-03 23:51:01 +00:00
rillig
bb2127170a Added "A package does not build. What shall I do?" to the FAQ. 2006-07-02 23:34:03 +00:00
rillig
9a71aeca42 Summarized some places where you can find more documentation about pkgsrc. 2006-07-02 22:45:17 +00:00
rillig
d1fb48921a When INTERACTIVE_STAGE is set and not only contains "fetch", the package 
cannot be built by the bulk builds.
 2006-07-02 12:42:39 +00:00
rillig
c86a5ea8d8 Removed a duplicate word. 2006-07-02 12:42:07 +00:00
rillig
dc0b3feba2 Added a missing word. 2006-07-02 10:01:11 +00:00
rillig
0e4d5a0370 Added documentation for the SUBST framework. 2006-07-01 23:48:16 +00:00
rillig
0e08058593 Removed the policy that INTERACTIVE_STAGE should not contain "fetch", as 
it had not been discussed before.
 2006-07-01 12:51:30 +00:00
rillig
a8a113975d Added another rationale that "fetch" should not be in INTERACTIVE_STAGE. 2006-07-01 09:26:41 +00:00
rillig
98c529535b INTERACTIVE_STAGE should not be set to "fetch". 2006-06-30 09:41:39 +00:00
rillig
c877c509fb Updated the chapter on editing the pkgsrc guide. It had been outdated. 2006-06-30 09:25:34 +00:00
rillig
979ebfea0a Added a chapter "The implementation of the bulk builds" that describes 
how the bulk builds should look like in the future. It is a design
document and subject to discussion.
 2006-06-30 08:58:16 +00:00
rillig
f091955572 Using printf is another way to print an arbitrary string. 2006-06-29 13:37:46 +00:00
rillig
a7bdcb585e Added more entries for "undefined reference to ..." and an explanation 
on how to fix them.
 2006-06-29 11:41:04 +00:00
rillig
ccb53ecb27 Reordered the sections so that the general ones are at the beginning, 
followed by the ones specific to a phase. Added an "undefined reference
to ..." section.
 2006-06-29 11:29:46 +00:00
rillig
d1b0a0eefb Added a note that the name LOCALBASE stems from FreeBSD. 2006-06-27 11:07:12 +00:00
rillig
8780ac8c7b INSTALLATION_DIRS creates directories with the correct ownership. 2006-06-26 23:28:51 +00:00
rillig
68f085bf80 Documented some more file names, so that almost all files in pkgsrc are 
covered now by the documentation.
 2006-06-25 10:33:33 +00:00
rillig
d8b7a83f1f Added buildlink3.mk and options.mk to the list of optional package files. 2006-06-25 10:02:10 +00:00
rillig
fe253c8065 Moved the pkgsrc-bugs mailing list from the user's part to the 
developer's part, since we got a non-PR bug report on it again. Sorted
the other mailing lists by relevance instead of alphabetically.
 2006-06-23 10:12:28 +00:00
rillig
d60a15dfe9 The GNU binutils are still not supported under Solaris (I just tried it). 2006-06-23 05:00:55 +00:00
rillig
bcb61c6269 Documented the ${MASTER_SITE_FOO:=package/} syntax, which may be 
confusing to pkgsrc beginners. (At least it had been to me.)
 2006-06-22 07:30:38 +00:00
rillig
71c4773555 The specification of individual variables is further explained in the 
pkglint documentation.
 2006-06-21 08:50:40 +00:00
rillig
c8153aab7c The advice to use CFLAGS+= foo instead of CFLAGS= foo does not belong 
into the developer's part, and has since been moved to the user's part.
Rewrote the section on "how to pull in variables from mk.conf", since
the word "problem" in the first sentence had bothered me over and over
again. Removed the documentation for adding "fetch" to
INTERACTIVE_STAGE, since we already have FETCH_MESSAGE for that purpose.
Added "extract" to the valid values for INTERACTIVE_STAGE, since there
might be password-protected distfiles. Now that "fetch" is excluded from
INTERACTIVE_STAGE, it is a list of _phases_ (note the misnomer here)
that are required once for every build of a package. "fetch" only needs
to be done once at all, so it is good to have these issues separated.
 2006-06-21 08:42:21 +00:00
rillig
8425585ef7 Added a section for commonly used abbreviations, since it took me quite 
a while to figure out what ICE means.
 2006-06-17 10:26:53 +00:00
darcy
e7230933bd Add text to help explain when bumping PKGREVISION is appropriate or not. 
As discussed with Greg Troxel.
 2006-06-14 21:20:16 +00:00
rillig
22f862db78 Fixed a typo and some wording. Synced with bsd.options.mk 1.56. 2006-06-08 08:45:45 +00:00
rillig
9c62b4f5ee Rewrote and shortened the section on C preprocessor macros. Renamed some 
headings to follow a common structure.
 2006-06-01 09:31:18 +00:00
rillig
d1153fd1f0 Added a chapter "creating a pkgsrc package" that serves as an 
introduction to the developer's guide.
 2006-06-01 08:39:03 +00:00
ghen
a4b367e139 Adapt pkgsrc documentation examples to the new databases/openldap-client 
package.
 2006-05-31 18:54:32 +00:00
rillig
0deb1d0320 Clarified a bit on why updating pkgsrc using a tar file is discouraged. 2006-05-31 11:44:07 +00:00
rillig
f5a5f1f754 This package needs a current htdocs-share to produce valid HTML. While 
here, fixed some pkglint warnings and set DISTNAME to the package name,
banned the htdocs-share*.tar.gz to DISTFILES, where it belongs.
 2006-05-29 08:55:31 +00:00
rillig
74557ce3a8 Rewrote the appendix covering the directory layout on ftp.NetBSD.org. 2006-05-29 07:47:34 +00:00
rillig
1c0fc3904b Rewrote the chapter on "getting pkgsrc and keeping it up-to-date" based on 
the current discussion on the pkgsrc-users mailing list.
 2006-05-28 20:37:52 +00:00
mishka
b2ce9ede48 Do not pass HTML results through tidy - DocBook XSLT produces valid HTML output. 2006-05-24 07:55:59 +00:00
mishka
dca1020799 Merge XSLTs from the NetBSD Guide: 
- indent chunker output,
    - process single pkgsrc.html as HTML 4.01 Transitional document.
 2006-05-24 07:54:11 +00:00
rillig
a669c02709 _FETCH_MESSAGE has been replaced with FETCH_MESSAGE. 2006-05-23 09:09:13 +00:00
rillig
a68e85797c + FAQ: Why do packages ignore my CFLAGS? 2006-05-21 12:23:29 +00:00
rillig
a6950e8842 Provided an abstract that sounds more like a definition. 2006-05-19 22:05:09 +00:00
rillig
d460ddc3b0 Clarified that pkgsrc users are not necessarily "end users". 2006-05-19 22:04:19 +00:00
rillig
7b2370f35d Happy new year. 2006-05-19 21:44:37 +00:00
rillig
6c7240d5fe Added definitions for the people involved in pkgsrc. 2006-05-19 21:43:23 +00:00
rillig
55738b9263 The difference between submission of binary and source packages is 
emphasized by using two distict sections for them.
 2006-05-19 21:08:42 +00:00
reed
fd3950fc40 Change "backspace" into "backslash". 
Reported by  Jonathan Towne in PR #33480.
 2006-05-15 16:28:19 +00:00
rillig
fd35d0a402 Added the word "internals" to the title of part III. Added a chapter 
with general design guidelines. Fixed the statement that there are only
two parts.
 2006-05-12 23:03:22 +00:00
rillig
127ca5704c Fixed the detab target. 2006-05-10 22:43:51 +00:00
rillig
b019c05b88 Ran "make detab". 2006-05-10 22:43:15 +00:00
rillig
b88e059259 Added the word ``internals'' to the title of part III and provided a 
short introduction.
 2006-05-10 22:42:30 +00:00
rillig
e300a151d9 Added part III, which is about the pkgsrc infrastructure. It currently 
contains the chapter about porting pkgsrc to new platforms (formerly in
part II) and a new chapter on regression tests.
 2006-05-10 20:56:00 +00:00
rillig
7bc0a76019 + Why does make show-var VARNAME=BUILDLINK_PREFIX.foo say it's empty? 2006-05-10 16:19:55 +00:00
rillig
d481d20fe8 Added a chapter in the developer's part for frequently asked questions. 2006-05-10 13:58:34 +00:00
jlam
2797f2c4fb Add two new capabilities to the pkginstall framework: 
(1) Allow specifying the numeric UID and GID for users and groups in
    /etc/mk.conf by setting PKG_UID.<user> and PKG_GID.<group> to
    those values.  If these values are specified, then the +USERGROUP
    script will verify that existing users and groups match the
    requested UIDs and GIDs for the package, and otherwise create them
    with these UIDs and GIDs.  For example:

	PKG_UID.courier=	10001
	PKG_GID.mail=		6

    In this example, the courier-authlib binary package will be created
    to use uid 10001 for the "courier" user and gid 6 for the "mail"
    group.

(2) Allow a package to request that users and groups be created prior
    to configuring or building a package by setting USERGROUP_PHASE
    to "configure" or "build".  Because the reason for this is typically
    to hardcode the UIDs and GIDs of requested users and groups directly
    into the package's executables, these hardcoded values will be
    automatically determined and put into the +USERGROUP script.  For
    example:

	USERGROUP_PHASE=	configure

	PKG_GROUPS=	qmail nofiles
	PKG_USERS+=	qmaill:nofiles
	PKG_USERS+=	qmailq:qmail

    In this example, the users and groups are created before the
    configure phase when building qmail, and the qmail binary package's
    +INSTALL script will try to create (or verify) users and groups
    with the same UIDs and GIDs that were used during the build.

As part of these changes, the format for PKG_USERS and PKG_GROUPS has
changed -- the optional parts of the corresponding entries are no
longer used and cannot be specified.  Instead, the following variables
should be set:

        PKG_GID.<group> is the group's numeric GID.
        PKG_UID.<user> is the user's numeric UID.
        PKG_GECOS.<user> is the user's description.
        PKG_HOME.<user> is the user's home directory.
        PKG_SHELL.<user> is the user's login shell.

A separate commit will follow which will fix all packages that set
PKG_USERS and PKG_GROUPS to use the new syntax and variables.
 2006-04-23 00:00:43 +00:00
lukem
f2b2c16894 use "tnftp" instead of "lukemftp" 2006-04-22 05:43:51 +00:00
rillig
d47c2c3393 Replaced SITES_* with SITES.*. 2006-04-21 07:55:16 +00:00
rillig
0747a13bdd Specified the structure and interpretation of the WRAPPER_REORDER_CMDS 
variable.
 2006-04-21 07:54:12 +00:00
rillig
86da515abd Documented (parts of) the wrapper phase. 2006-04-21 07:30:32 +00:00
rillig
a61f2d33e4 Added the binary packages URLs for Solaris 9. 2006-04-18 12:56:53 +00:00
jlam
d19161d212 Modify the plist module to automatically transform "^share/locale" in 
PLISTs to "${PKGLOCALEDIR}/locale" for the installed PLIST.  This is
similar to the work that's already done to automatically handle
PKGINFODIR and PKGMANDIR.  PLISTs in pkgsrc will be modified so that
they would just list the message files to be under "share/locale".
USE_PKGLOCALEDIR must continue to be set in package Makefiles so that
localedir substitutions happen at post-configure time.
 2006-04-17 06:12:46 +00:00
jlam
f85023f9da Now that all info file entries have been pushed from INFO_FILES into 
the PLISTs, drop support for listing info files in INFO_FILES.  The
INFO_FILES variable is now strictly defined/undefined.
 2006-04-16 04:27:17 +00:00
reed
103077021c Add missing close "para" tags in the INFO_FILES and PKGINFODIR 
paragraphs.
 2006-04-08 07:43:41 +00:00
reed
d31af5019d Move around text and rewrite some of the text 
explaining BUILDLINK_API_DEPENDS and
BUILDLINK_ABI_DEPENDS.
 2006-04-06 07:57:10 +00:00
reed
2f2c7d581f Fix documention about about BUILDLINK_API_DEPENDS (was 
BUILDLINK_DEPENDS) and BUILDLINK_ABI_DEPENDS.pkg (was
BUILDLINK_RECOMMENDED).

Noticed
 2006-04-06 07:33:30 +00:00
reed
5abef9be14 Over 1200 files touched but no revisions bumped :) 
RECOMMENDED is removed. It becomes ABI_DEPENDS.

BUILDLINK_RECOMMENDED.foo becomes BUILDLINK_ABI_DEPENDS.foo.

BUILDLINK_DEPENDS.foo becomes BUILDLINK_API_DEPENDS.foo.

BUILDLINK_DEPENDS does not change.

IGNORE_RECOMMENDED (which defaulted to "no") becomes USE_ABI_DEPENDS
which defaults to "yes".

Added to obsolete.mk checking for IGNORE_RECOMMENDED.

I did not manually go through and fix any aesthetic tab/spacing issues.

I have tested the above patch on DragonFly building and packaging
subversion and pkglint and their many dependencies.

I have also tested USE_ABI_DEPENDS=no on my NetBSD workstation (where I
have used IGNORE_RECOMMENDED for a long time). I have been an active user
of IGNORE_RECOMMENDED since it was available.

As suggested, I removed the documentation sentences suggesting bumping for
"security" issues.

As discussed on tech-pkg.

I will commit to revbump, pkglint, pkg_install, createbuildlink separately.

Note that if you use wip, it will fail!  I will commit to pkgsrc-wip
later (within day).
 2006-04-06 06:21:32 +00:00
jlam
29fefe52e3 * Creates a new variable PKGINFODIR (named similarly to PKGMANDIR) 
that is a purely user-settable variable to represent the relative
  path under ${PREFIX} where info files are stored and "dir" files
  are managed.  PKGINFODIR defaults to "info".  INFO_DIR still works,
  but will be obsoleted after the 2006Q1 branch.

* Modify GNU_CONFIGURE_INFODIR to only honor ${PKGINFODIR} if the
  package installs directly into ${PREFIX} and not some subdirectory
  under ${PREFIX}.  This fixes packages that don't really honor
  $(infodir) all that well, and also avoids PLIST problems relating
  to directory removal for those packages.

* Since the majority of Emacs Lisp packages use GNU_CONFIGURE, just
  set GNU_CONFIGURE_INFODIR directly to ${EMACS_INFOPREFIX}, which is
  the Emacs-distro-specific location for info files.  Also pass
  EMACS_INFOPREFIX through PLIST_SUBST for PLIST substitution.

* INFO_FILES should be defined if the package installs info files.
  If the info files are not listed in the PLIST, then INFO_FILES
  must list the filenames for the info files installed by the package,
  which are assumed to be located in ${PREFIX}/${PKGINFODIR}.

* The plist module can now better detect info files listed in PLISTs
  and exports a command to the pkginstall module to append info file
  names to the +INFO_FILES scriptlet at install-time.

* The print-PLIST target is updated to properly list info files in
  the auto-generated PLIST.

* The check-files code is updated to skip all "dir" Info database files.
 2006-03-20 01:48:57 +00:00
wiz
ece6e09d33 pkgsrc-users@ is the new default maintainer. 2006-03-17 19:45:30 +00:00
wiz
cb6329d205 Update mailing list information from subscription page and jlam's posting 
when pkgsrc-users was created.
 2006-03-17 19:45:07 +00:00
rillig
d05133fc3c For solving the Solaris/libtool problem, libtool-base needs to be 
reinstalled.
 2006-03-14 14:04:54 +00:00
rillig
78b38aeaa0 Fixed references to non-existent packages. When a package needs source 
files from another package, it should just add that other package to
DISTFILES instead of (cd otherpackage && make extract).
 2006-03-12 11:34:09 +00:00
jlam
949723070b ossaudio.buildlink3.mk instances should now be "oss.buildlink3.mk" 2006-03-09 21:45:51 +00:00
rillig
547ad94911 Documented the REPLACE.* and REPLACE_FILES.* variables. Added a note for 
the old names.
 2006-03-09 16:34:08 +00:00
wiz
dda9800f99 Correct path in example line for pre-build.local. 2006-03-03 22:22:07 +00:00
rillig
4a7a902fd7 There are some rules for adding a change to doc/CHANGES when the 
PKGREVISION is bumped. If none of the rules applies, the behavior is
developer-dependent.
 2006-03-02 23:08:40 +00:00
rillig
c0186393a8 Minor wording change. 2006-03-01 17:16:21 +00:00
reed
71f42efe60 Space between DragonFlY and BSD. 2006-03-01 00:04:30 +00:00
reed
197d86c91a Add a note about X11_TYPE about DragonFly's default. 
(I had this in my pkgsrc since November.)
 2006-03-01 00:01:51 +00:00
rillig
30e1783f6b Indented the output of "make show-options" properly. 2006-02-28 11:50:07 +00:00
rillig
74a3b41c9c Updated the "Using pkgsrc" chapter a bit, making it more 
platform-independent. Explicitly added URLs where to find binary
packages for Solaris.
 2006-02-22 01:30:25 +00:00
rillig
a67eedd930 Bootstrapping pkgsrc to build 64-bit binaries on Solaris with SunPro is 
non-trivial. At least, it's documented now.
 2006-02-18 19:59:12 +00:00
rillig
8d47b2a538 After the 2006Q1 branch, SITES_${file} should be replaced with 
SITES.${file}.
 2006-02-18 17:11:50 +00:00
rillig
448320f2d9 Documented the variable ALLOW_VULNERABLE_PACKAGES to be useful for bulk 
builds.
 2006-02-18 17:07:33 +00:00
rillig
dc9a324f58 Added a new chapter to the developer's guide that explains how to port 
pkgsrc to new operating systems, how to add support for a compiler, and
maybe more.
 2006-02-18 01:46:43 +00:00
rillig
a26429dde9 Documented the new mk/scripts/extract command. 2006-02-17 20:38:17 +00:00
rillig
377b70b74e On Solaris, it may be necessary to redefine WRAPPER_SHELL to work around 
the buggy /bin/ksh.
 2006-02-14 17:10:15 +00:00
rillig
529c1ceea2 Documented the broken /bin/ksh on Solaris (Fixes PR 32826). Compressed some 
simple itemizations.
 2006-02-14 10:12:39 +00:00
rillig
d917c825cf Removed trailing white-space. 2006-02-12 14:44:59 +00:00
rillig
ff0341dde1 Added a description for INSTALLATION_DIRS. Reworded the text of the 
build.install section.
 2006-01-27 04:06:25 +00:00
rillig
a3fbb6fc68 Added a reference to the file where CHECK_FILES and CHECK_INTERPRETER can 
be found. Removed CVS_USER, since it doesn't exist anymore.
 2006-01-22 21:56:13 +00:00
rillig
7acc70578f Added missing </para>. 2006-01-16 00:29:23 +00:00
minskim
e7afab3e12 Sync with htdocs and add NetBSD.css so that "make install" works. 2006-01-14 17:18:31 +00:00
reed
ec24b3ed93 Cross reference the "tools phase" section to 
the new tools chapter.

I removed the TODO here; maybe some text should still be added
for this chapter?
 2006-01-13 17:55:27 +00:00
reed
35d10ae652 Add a "tools" chapter. Documents the USE_TOOLS. 2006-01-13 17:42:33 +00:00
hubertf
3a6f5296c8 Add an example for the pkg options variables in /etc/mk.conf 2006-01-13 17:21:07 +00:00
wiz
5cbcb1ecd6 s/unstripped/stripped/ 2006-01-12 21:46:33 +00:00
rillig
c7184fa02f Documented CHECK_FILES and CHECK_INTERPRETER as being useful for bulk 
builds.
 2006-01-12 11:22:40 +00:00
rillig
638d9123fa Added a README file that describes where to get some basic information 
about DocBook. Without that reference I felt it was hard to write
anything useful because I didn't know which annotations to use.
 2006-01-11 22:39:49 +00:00
rillig
4d144f17ea [The ''install'' phase] Documented the various INSTALL_* variables. 2006-01-11 22:35:31 +00:00
hubertf
1b03349638 it's autit-package*S* 
Noted by Stephen M. Rumble <stephen.rumble@utoronto.ca> in private mail.
 2006-01-10 23:50:40 +00:00
rillig
f039d421e9 Even if you build a package from source, you don't gain any security 
unless you have completely read and understood the source code of all
the tools involved in building the package.
 2006-01-07 22:10:31 +00:00
rillig
d6ec91875d Cleaned up a bit on the wording. 2006-01-07 21:42:34 +00:00
hubertf
8e66747b43 Back out previous commit - it was not intended to be committed 
Tnx @ wiz
 2006-01-04 06:37:59 +00:00
hubertf
4e3b054b94 Update vpnc to 0.3.3. Changes: 
* ignore \r in config files
  * (hopefuly) fixed 64bit bugs (Nicolas Boichat and Zach Brown)
  * added support for "Split-Net" Routing
  * introduced vpnc-script and removed vpnc-connect
  * always search for configfiles in /etc/vpnc/ expect if the
    filename contains at least one "/"
  * only read /etc/vpnc/default.conf and /etc/vpnc.conf if no other
    configfiles are provided
  * various other fixes contributed by Anton Altaparmakov, Randy
    Chou, "krabat", Andre Vanha and Nikolay Sturm
 2006-01-03 21:48:09 +00:00
jschauma
198db3595b clarify which variables are depracated (USE_FOO) for pkg options 2006-01-02 22:30:52 +00:00
jlam
e0f1bb63ee Correct section title (copy and paste error). 2005-12-29 15:00:10 +00:00
jlam
1c16dde6c7 Update the pkgsrc guide to reflect the following changes to the pkginstall 
framework:

   * USE_PKGINSTALL is no longer needed.

   * X11 font directories should be listed in FONTS_DIRS.<type>

   * fonts.mk is no longer needed as the functionality has been completely
     reimplemented within the pkginstall framework.

   * PKG_UPDATE_FONTS_DB may be set to "yes" or "no" to indicate whether
     the fonts databases should be updated or not.  This defaults to "yes".
 2005-12-29 14:59:03 +00:00
kim
98ce3e23f2 "Microsystems" -> "Sun Microsystems" 
Fixes PR 32366
 2005-12-24 10:11:07 +00:00
minskim
1f170021bd Document how to register font map files in packages installing TeX 
font maps.
 2005-12-14 23:55:17 +00:00
dillo
79e46305a4 Document that ${PKGBASE} cannot be used in defining PKG_OPTIONS_VAR. 2005-12-06 19:58:35 +00:00
rillig
e55de1a330 Added a note that using the binary bootstrap kits only works for 
privileged builds that use LOCALBASE=/usr/pkg.
 2005-12-05 18:04:39 +00:00
rillig
4d235fb633 Reverted the last change after massive protest from agc. 2005-12-04 17:22:24 +00:00
rillig
a330b60fe7 Added documentation for the make(1) variables that are most likely to be 
overridden in a user's mk.conf file.
 2005-12-04 17:05:22 +00:00
rillig
8bf422cbd9 Don't encourage users to abuse the patch framework for installing 
pkgsrc-specific files into ${WRKSRC}. I've lately seen too many patches
against /dev/null that contain RCS Ids.
 2005-12-02 13:52:31 +00:00
rillig
b9f650f345 Reordered the configuration files for bulk builds. Since the 
build.conf file contains a setting for choosing another mk.conf file,
it should come first. Updated the wording of the text.
 2005-11-29 09:58:27 +00:00
jlam
e6e49a2f0f Change all instances of including mk/ghostscript.mk into asking for 
the appropriate tool via USE_TOOLS (usually "gs:run"), and remove
ghostscript.mk.  This change removes a rather out-dated file from
pkgsrc and switches packages to use the more compact implementation
of the Ghostcript-handling inside the tools framework.
 2005-11-28 06:41:20 +00:00
rillig
500b58c211 Somehow, all the __i386__ were missing an additional underscore. Fixed it. 2005-11-24 10:53:44 +00:00
rillig
2330f610f9 Fixed the wording in the "CPP defines" section. Added more examples of 
predefined CPP macros for some platforms.
 2005-11-24 10:03:37 +00:00
rillig
750c275eb7 Inserted punctuation into the list of predefined CPP macros to make it 
more readable.
 2005-11-21 09:33:39 +00:00
rillig
d5650e7dc3 Added more documentation on the predefined C preprocessor macros. 2005-11-21 09:27:04 +00:00
rillig
2a72606c23 Updated the example use of pkglint. 2005-11-20 17:14:26 +00:00
rillig
fa35d64150 Added a section on how to keep pkgsrc up-to-date. 2005-11-20 10:02:31 +00:00
yyamano
24392a32bc Remove --pkgsrcdir option. Now bootstrap uses pwd. 
Applied patch provided by Antoine Reilles. Fix PR 31398.
 2005-11-18 14:44:45 +00:00
wiz
3317893a77 Grammar fix. 2005-11-17 17:48:49 +00:00
erh
fedba22fbe Mention the new ALLOW_VULNERABILITIES and SKIP_AUDIT_PACKAGES variables. 2005-11-16 22:07:04 +00:00
minskim
f694539868 Use up-to-date htdocs so that DocBook DTD is found when 
docbook-xml>=4.4 is installed.
 2005-11-13 09:24:32 +00:00
minskim
ed7f97e875 Add a section on how to use print/teTeX/module.mk. Thanks to hubertf@ 
and tonio@ for review.
 2005-11-13 03:27:20 +00:00
rillig
71a76c136c Globally replaced X-Windows with X11. See the X(7) man page for details. 2005-11-08 22:19:34 +00:00
reed
179967620f Add "para" tags for a "note" paragraph. This fixed a problem 
where a "varname" was immediately followed (without a space)
the next word.
 2005-11-08 16:39:47 +00:00
reed
84257a3ced Add some docs about PKGMANDIR. 2005-11-08 03:45:37 +00:00
rillig
f9f3c44fe8 Added a rationale for the last commit, which had been unintended, but 
nevertheless useful.
 2005-11-04 14:00:21 +00:00
rillig
84dc0f88aa Updated pkglint to 4.36. 
Implemented checking for enumeration types. Added new types Filemask,
Filename, Language, Option, Pathmask, Pathname, Stage, Varname and
WrksrcSubdirectory. Made the check for URLs stricter. Added some
variables to the makevars.map file.
 2005-11-04 13:57:35 +00:00
rillig
98b45c1de4 Note that the distfiles are extracted to WRKDIR. 2005-11-04 11:55:31 +00:00
salo
5fa4326859 Don't quote PKG_OPTIONS_VAR example in the description. 
The value _must not_ be in quotes so don't confuse users.  (hit by martin@)
 2005-11-04 09:49:37 +00:00
rillig
2dcf0e8faf Added the default value of CONFIGURE_DIRS. Rewrote the ``build'' phase 
description to have the same structure as the ``configure'' phase
description.
 2005-11-03 19:29:54 +00:00
rillig
e8414cff1a Documented the use of CONFIGURE_DIRS, as pkglint has got a new error 
diagnostic that need this explanation.
 2005-11-03 19:06:50 +00:00
rillig
58f5fad9aa Reformatted and improved the explanation of the directories. 2005-11-03 18:15:47 +00:00
tv
ea6e29af10 Add __INTERIX. 2005-11-03 17:31:57 +00:00
tv
4176a7b269 Add note about Interop X Server. 2005-11-03 17:30:50 +00:00
rillig
69b1807a43 Added explanations for some of the directories used in the build 
process. More will follow.
 2005-11-03 17:06:13 +00:00
rillig
e03b82d052 Wrote an introduction and converted the itemize list of main targets 
into sections. These sections are still very incomplete.
 2005-11-03 16:43:59 +00:00
rillig
9a8229ab10 Added __DragonFly__. 2005-11-03 16:04:55 +00:00
rillig
9ca9843a66 Rewrote the section about CPP defines, as NetBSD is not the only target 
platform of pkgsrc. It now lists some commonly known predefined macros
for operating systems, CPUs and compilers.
 2005-11-03 02:51:45 +00:00
tv
3642f3e861 Add convenience meta-pkg "pkgsrc-guide-tools-1.0", with runtime 
dependencies on the tools used to build doc/guide.  doc/guide still uses
BUILD_DEPENDS on the tools (so that it's still possible to build for
certain output types with minimal dependencies); it does not depend on
the meta-pkg.
 2005-11-03 01:57:15 +00:00
tv
7b725c1e83 Fix uses of <emphasis> in the Interix section. 2005-11-02 21:52:15 +00:00
tv
bfc8114ac4 Change the grammar of the esound paragraph slightly so it's easier to read. 2005-11-01 17:19:09 +00:00
tv
90adf6235f Add "Limitations of the Interix platform" subsection. 2005-11-01 17:14:04 +00:00
tv
a769092bbb Fix typo and move the "known issues" section for Interix into the Guide. 2005-11-01 14:27:10 +00:00
tv
03b160018b Add note about Interix hotfixes. 2005-11-01 14:16:24 +00:00
rillig
ad74bfb9df Reindented all <programlisting>s. 2005-10-23 11:25:58 +00:00
hubertf
b0f53277e3 Expand section on CPP defines, thanks to salo. 
XXX can anyone rebuild this stuff, and commit to htdocs?
 2005-10-23 00:41:54 +00:00
hubertf
f2abab7519 reorg, cosmetic only - sort, add comments 2005-10-17 06:19:31 +00:00
hubertf
c2c4c491d1 make the introduction heading symmetric with the NetBSD guide 2005-10-17 06:07:38 +00:00
rillig
e351747080 Rewrote the sections explaining the distinfo file and the WRKSRC 
variable. They had been out-of-date and lacked complete sentences.
 2005-10-07 18:30:17 +00:00
rillig
bddf153e97 WRKSRC is not a subdirectory of WRKDIR. 2005-10-07 15:49:01 +00:00
rillig
833cbcec9d The MAINTAINER variable is now described in complete sentences. 2005-10-07 15:45:24 +00:00
rillig
eccc360954 Added ../../../htdocs as a secondary default value for HTDOCSDIR. 2005-10-07 12:14:26 +00:00
rillig
e4c254dd18 Removed the -3 option from the example call to createbuildlink. 2005-10-07 09:56:12 +00:00
dillo
af27c79141 - add 2005 to copyright years 
- improve documentation of option names and description

Reviewed by wiz.
 2005-10-05 13:59:56 +00:00
rillig
5946936ffc Replaced "# defined" with "yes" in Makefile variables like GNU_CONFIGURE, 
NO_BUILD, USE_LIBTOOL.
 2005-09-28 20:52:18 +00:00
rillig
3d6172efa4 Fixed typo. 2005-09-28 13:02:44 +00:00
reed
c27b2ad802 Plural versions. 2005-09-20 06:25:11 +00:00
reed
a889f46cf1 Add note about using bmake when using bootstapped system. 2005-09-15 00:04:59 +00:00
reed
087f1de0ac Add note about using bmake instead of make (for bootstrap users). 2005-09-14 17:04:17 +00:00
reed
cf31a5c72a Mention USE_TOOLS also may express a dependency. 
Todo: USE_TOOLS should be documented, such as :pkgsrc, :run, :build
(I started working on a files/tools.xml.)
 2005-09-14 16:46:13 +00:00
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