Commit graph

426 commits

Author SHA1 Message Date
rillig
905959284d Added an example section to the "creating a package" chapter, which
explains how I created a nontrivial package, www/nvu. It includes many
pitfalls that have never been documented before.
2006-10-21 20:39:24 +00:00
rillig
f38c98f181 Reindented to have more text per line. 2006-10-21 11:58:18 +00:00
rillig
8711fc9d43 Reworded to make reading easier. 2006-10-21 11:57:11 +00:00
ben
418b77a193 Update the PostgreSQL versions referenced in buildlink.xml 2006-10-18 03:06:14 +00:00
wiz
1f540ae4b1 English improvement. 2006-10-13 21:21:11 +00:00
yyamano
20b5793e85 We don't have a list of licenses in pkgsrc/mk/defaults/mk.conf anymore.
Pointed out by kano@.
2006-10-11 14:32:56 +00:00
rillig
ec77758bec Some package's self-tests require a lot of high-quality random data, so
the bulk build may seem to hang on otherwise idle machines.
2006-10-09 22:08:41 +00:00
mishka
c2aaeefffb Add documentation for MASTER_SORT_RANDOM variable. 2006-10-09 13:15:07 +00:00
rillig
cc6b1b76a7 Stated some major goals of pkgsrc:
- high quality of the generated packages
- platform independence, portability
- uniform look and feel on all platforms

Feel free to add you own goals.
2006-10-07 09:31:16 +00:00
rillig
b4f2c7b318 Changed to htdocs-share-20061007.tar.gz. 2006-10-07 09:29:48 +00:00
rillig
97a56aa9d3 Changed to the current htdocs-share archive. Added a target to regenerate
the archive, since that has been undocumented up to now.
2006-10-07 09:29:19 +00:00
rillig
c482c67daf Minor rewording. 2006-10-07 01:24:00 +00:00
rillig
5df3ea2a0b KDE packages should make use of meta-pkgs/kde3/kde3.mk. 2006-10-06 18:12:48 +00:00
wiz
e329b5ac78 Four root directories for pkgsrc, not three. 2006-10-02 17:56:27 +00:00
rillig
5c76cf883b After editing the package Makefile, it is usually necessary to run
"bmake clean".

The url2pkg program can create packages for Perl modules almost
completely.
2006-10-02 16:52:22 +00:00
rillig
28dbf6e215 Added the default values for the four root directories of pkgsrc. 2006-10-02 16:37:47 +00:00
rillig
18f01f78ce Not all tar(1)s know the -z option. 2006-09-25 09:45:31 +00:00
rillig
462adfe965 Added a new chapter to the pkgsrc user's guide, which describes the file
system layout of pkgsrc.
2006-09-19 17:50:38 +00:00
rillig
786378f1fa Replaced "regenerate" with "regen" to save me from typing too much. 2006-09-18 22:36:48 +00:00
rillig
02676731f9 Added an FAQ entry for the "Makefile appears to contain unresolved
cvs/rcs/??? merge conflicts" error message.
2006-09-18 22:27:54 +00:00
rillig
1078f659ea Moved the section "selecting the compiler" from the chapter "using" to
"configuring".
2006-09-18 13:25:37 +00:00
rillig
a2111ba288 Provided an introduction to configuring pkgsrc.
Removed the link to the "undefined reference" section in the developer's
guide, since that kind of problem is not expected to be solved in
mk.conf.
2006-09-18 12:52:20 +00:00
rillig
2e8a716cd1 Small improvements of the wording. Mentioned that on mirrors, the base
directory may be different from /pub/pkgsrc.
2006-09-18 12:16:25 +00:00
ben
69b869594b By request of Thomas, document some Darwin details. 2006-09-17 23:55:28 +00:00
jmmv
4e66ee8957 Clarify where gtk-doc documentation should be installed to match current
practices in pkgsrc.
2006-09-17 15:48:45 +00:00
wiz
5f8206d726 Use &cprompt;. Do not mention not-existing INET_COUNTRY.
Describe MASTER_SORT and MASTER_SORT_REGEX.
2006-09-13 23:39:07 +00:00
wiz
560966e88a Document BATCH. Undocument deprecated BUILD_USES_MSGFMT.
Document OSVERSION_SPECIFIC.
2006-09-13 23:38:21 +00:00
wiz
78a87435f0 Document LDFLAGS. 2006-09-13 23:36:47 +00:00
wiz
664c8c8551 Use &cprompt; 2006-09-13 23:34:05 +00:00
wiz
ebbf34a05d Use &rprompt; 2006-09-13 23:33:18 +00:00
wiz
5c12ffda83 Remove section about "Commonly used abbreviations" -- the only cited
abbreviation isn't used at all in the guide.
2006-09-13 23:31:15 +00:00
wiz
3cb7fe02d4 Use &cprompt; 2006-09-13 23:30:15 +00:00
wiz
4fb56e683e Use &cprompt; and &rprompt;
Add section for people with too much time on their hands.
2006-09-13 23:27:31 +00:00
wiz
b5e337f013 Use documented 'make makedistinfo' instead of undocumented 'make makesum'
in example.
2006-09-13 23:26:21 +00:00
wiz
e627f00107 Reindent, slight improvements. 2006-09-13 23:25:14 +00:00
wiz
55b4f7a9bf Document MANCOMPRESSED_IF_MANZ. 2006-09-13 23:24:40 +00:00
wiz
14a42c23d7 Describe valid values for MOTIF_TYPE. 2006-09-13 23:23:39 +00:00
wiz
60507078b9 Improve markup. Describe MASTER_SITE_BACKUP and MASTER_SITE_LOCAL.
Document NO_INSTALL_MANPAGES. Describe "The package phase".
Add section about "Cleaning up". Document DEPENDS_TARGET.
Document the bin-install target. Improve UPDATE_TARGET description.
Use &rprompt; and &cprompt; instead of <prompt>.</prompt>.
Document replace and index targets.

Reindent and break lines for 80 characters.
2006-09-13 23:23:00 +00:00
wiz
06cbeb626e It seems that the contents of <screen> should start in the first column
for consistency. Make it so.
2006-09-10 19:51:49 +00:00
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