Commit graph

487 commits

Author SHA1 Message Date
wiz
6206c1ab29 Remove accidental extra character. 2006-09-10 19:36:41 +00:00
wiz
1e1f4b6ed9 Fix typo in markup. 2006-09-10 19:36:31 +00:00
wiz
e1a5d0b9a3 Avoid extra whitespace in <para>. 2006-09-10 19:32:22 +00:00
wiz
77bca65f1d Document PLIST_SRC default. Avoid extra whitespace in <para>. 2006-09-10 19:31:42 +00:00
wiz
a565f838bd Avoid extra whitespace in <para>. Use more macros. 2006-09-10 19:30:56 +00:00
wiz
5b54bade7b Describe INSTALL_FILE and DEINSTALL_FILE. Improve introduction. 2006-09-10 19:29:52 +00:00
wiz
7935298a80 Remove extra whitespace in <para>. 2006-09-10 19:27:59 +00:00
wiz
b6e19a3259 Document PKGNAME_NOREV. Use more markup. Improve DIST_SUBDIR
description. Add section about programming languages. Describe
UNLIMIT_RESOURCES. Avoid extra whitespace in <para>.
Add section about emulation packages.
Add section about BROKEN and BROKEN_IN.
2006-09-10 19:27:34 +00:00
wiz
d9e85ef31d Document SVR4_PKGNAME; improve pkgdiff description; document
PATCHDIR, default setting of MESSAGE_SUBST, and FILESDIR.
Reindent.
2006-09-10 19:11:15 +00:00
wiz
8734183fc9 Whitespace cleanups. 2006-09-09 23:49:08 +00:00
wiz
707c77d465 Document ALLFILES, reindent a bit. 2006-09-09 23:47:40 +00:00
wiz
67ce634bfb No whitespace directly after to <para>. 2006-09-09 23:40:40 +00:00
obache
60f2f07996 Rename variable MAKEFILE to MAKE_FILE. 2006-09-09 04:21:30 +00:00
rillig
d8d62fd65d Added a reference to NetBSD's send-pr web page, for pkgsrc users that
don't have send-pr in their base system.

Fixes part of PR 34493.
2006-09-08 07:38:37 +00:00
jmmv
6600e38302 Remove part of a sentence that does not make sense from the new "hicolor theme"
section.  Found by wiz@.
2006-09-03 10:54:55 +00:00
wiz
f146b31eac Fix a typo. 2006-09-03 00:20:49 +00:00
schwarz
1168666396 fix spelling 2006-09-02 11:26:16 +00:00
jmmv
f7dff82948 Add some more GNOME-specific packaging and porting information:
- Document how to handle .desktop files.
- Document how to handle icons for the hicolor theme.
- Add a chapter detailing the GNOME meta packages, the packaging of new
  applications and the updatee procedure.

Also add some documentation on how to better handle and create patches.
2006-09-01 16:35:38 +00:00
schmonz
27579dfb14 Minimalist update for case-sensitive HFS+ support on Darwin. This
section needs to be internally reorganized.
2006-08-30 04:47:16 +00:00
schmonz
ad64f51cb9 s/ufsdiskimage/darwindiskimage/g as the script's been renamed. 2006-08-30 04:30:53 +00:00
jnemeth
ab4b65ff04 fix sentence fragment 2006-08-30 04:18:57 +00:00
ben
0d73d74d6b Make note that ufsdiskimage mounts asynchronous, which may be undesirableh. 2006-08-30 00:54:11 +00:00
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