summaryrefslogtreecommitdiff
path: root/doc/guide
AgeCommit message (Collapse)AuthorFilesLines
2019-12-06doc: Adjust case of NetBSD.orgleot1-2/+2
2019-12-06Update information to current reality (pkg-vulnerabilities is maintained byleot1-3/+3
pkgsrc Security Team and update pkg-vulnerabilities URL to the PGP signed one).
2019-11-22doc/guide: document the show-all target in the help sectionsrillig2-2/+30
2019-11-04doc/guide: fix type hinting in the placeholders utilityrillig1-4/+4
2019-11-04doc/guide: update for the type change of the variable BROKENrillig1-2/+2
2019-10-05doc/guide: Update htdocs-share to 20191005 (pkgsrc-2019Q3)leot2-7/+7
2019-08-30creating.xml: wrap line (no change to text)gutteridge1-2/+3
2019-08-25Add a description of 'make upload-distfiles' to the TeXlive package section.brook1-1/+14
TeXlive packages are unusual in avoiding direct downloads from the upstream CTAN repository. Therefore, developers must manually upload the appropriate distfiles. To help avoid forgetting this step, add a description to the Pkgsrc Guide in the section describing TeXlive packages.
2019-08-18doc/guide: fix references to relative directoriesrillig1-3/+3
For more than 15 years, pkglint complains about relative directories that take shortcuts. All relative paths between packages should first go up to the pkgsrc root and from there to the package.
2019-08-14Add a section to "Common packages" describing a typical TeXlive package.brook1-1/+37
2019-08-14Add a section to "Common packages" describing a typical R package.brook1-1/+20
2019-07-08doc/guide: Update htdocs-share to 20190708 (pkgsrc-2019Q2)leot2-7/+7
2019-05-20guide: Document TOOL_DEPENDSleot3-15/+45
Document TOOL_DEPENDS and clarify the differencies with BUILD_DEPENDS. Adjust previous BUILD_DEPENDS examples (all of them were actually TOOL_DEPENDS). XXX: No BUILD_DEPENDS example is provided, if you have any good and common XXX: BUILD_DEPENDS example please add it (a TODO comment was added regarding XXX: that). At least according a quick grep of BUILD_DEPENDS probably most of XXX: them are actually BUILD_DEPENDS and maybe all real BUILD_DEPENDS are via XXX: buildlink3.mk inclusion.
2019-05-05doc/guide: fill in the MASTER_SITE variables automaticallyrillig5-73/+94
Keeping these two lists in sync is not something that humans should do.
2019-05-03add help pagessevan1-1/+4
2019-05-03Drop the use of compression in CVS.sevan1-2/+2
"Do not use the cvs `-z` flag. The data stream gets out of sync, leading to corruption on the client, or causing the client to hang completely."
2019-04-29doc/guide: use Python instead of Perl for autogenerating help topicsrillig3-53/+36
The code is shorter and there's less line noise.
2019-04-28doc/guide: add autogenerated chapter containing topics from "bmake help"rillig8-7/+97
2019-04-28doc/guide: add chapters for getting helprillig5-4/+77
2019-04-28doc/guide: remove outdated text from the Makefiles chapterrillig1-55/+25
Most of the wording was based on the pkglint implementation from before 2015 and was too technical to be useful. Since 2015, bmake doesn't split the .for arguments on simple whitespace but uses brk_string as well, therefore that information was outdated.
2019-04-19Fix a thinko.leot1-2/+2
Pointed out by Benjamin Lorenz via PR pkg/54128, thanks! (and thanks to <joerg>)
2019-04-09doc/guide: Update htdocs-share to 20190409 (pkgsrc-2019Q1)leot2-7/+7
2019-04-03typo found with xmllintsevan1-2/+2
2019-04-03Switch to using cdn.NetBSD.orgsevan1-7/+7
pkg-vulnerabilities file is fetched from ftp.NetBSD.org via http, see tnf_vulnerability_base in pkgtools/pkg_install/files/lib/parse-config.c
2019-04-03Switch http links for ftp.NetBSD.org to https links for cdn.NetBSD.orgsevan3-25/+25
2019-03-03guide: Improve formattingleot1-2/+2
Reported by J. Lewis Muir via PR pkg/54030.
2019-02-28guide: Improve/extend documentation about FTP layoutleot1-10/+31
- Document the `current', `stable' and `pkgsrc-20xxQy' more extensively, from J. Lewis Muir via PR pkg/54019. Thanks! - Refers to `pkgsrc.tar.{bz,gz,xz}' instead of just `pkgsrc.tar.gz' to cover all compressed formats. - Document `pkgsrc-readmes.tar.{bz,gz,xz}'
2019-02-26guide: Document stable directory (link to latest quarterly branch)leot1-1/+5
Requested by J. Lewis Muir via PR pkg/54015.
2019-01-02guide: adjust example for BUILD_DEPENDStnn1-2/+2
2019-01-01Welcome to 2019!jnemeth1-3/+3
2018-12-30doc/guide: Update htdocs-share to 20181231 (pkgsrc-2018Q4)leot2-7/+7
2018-11-05doc/guide: document the purpose of distinfo storing patch checksumsrillig1-2/+7
See https://mail-index.netbsd.org/tech-pkg/2018/11/04/msg020426.html.
2018-10-03doc/guide: Update htdocs-share to 20181003 (pkgsrc-2018Q3)leot2-7/+7
2018-09-18Update documentation to mention PKGSRC_KEEP_BIN_PKGS, and remove nowmaya1-10/+9
stale information of DEPENDS_TARGET. Heads up by Dean Matzkov in PR pkg/52708. (Now to the right place, not the generated output)
2018-09-10doc/guide: Reword CONFLICTS usage suggestionsleot1-26/+31
Despite most CONFLICTS are automatically detected at package installation time it is still a good idea to manually mark CONFLICTS in order to fail as early as possible instead e.g. of failing at package installation time after possibly installing several (maybe not needed) dependencies. Pointed out by discussion on pkgsrc-changes@ by <jperkin>: <https://mail-index.NetBSD.org/pkgsrc-changes/2018/09/09/msg180626.html> Last two paragraphs from <jperkin>, thanks! Also discussed with <wiz>, thanks!
2018-07-24Remove onlamp links. (dead)maya1-12/+1
2018-07-05doc/guide: Update htdocs-share to 20180705 (pkgsrc-2018Q2)leot2-7/+7
2018-06-04Fix an error in the example of BUILDLINK_TRANSFORMminskim1-2/+2
2018-05-19doc/guide: explain single quotes in "Echoing a string exactly as-is"rillig1-2/+6
See https://mail-index.netbsd.org/pkgsrc-users/2018/05/11/msg026698.html
2018-05-11Fix a mispelling.leot1-2/+2
Pointed out by J. Lewis Muir via pkgsrc-users@, thanks!
2018-04-04doc/guide: Update htdocs-share to 20180404 (in preparation for pkgsrc-2018Q1).leot2-8/+13
Requested and thanks to <jperkin> via www@!
2018-01-01Update for 2018 new yearjakllsch1-3/+3
2017-11-27doc/guide: Use &*pkgsrc* XML entities instead of hardcoding themleot2-18/+11
Since the latest pkgsrc stable releases htdocs/share/xml/misc.ent had several XML pkgsrc related entities added and picked up via htdocs-share-*.tar.gz distfile. Use them instead of hardcoding a particular stable branch/release (e.g. 2009Q1 or 2016Q4) or using `pkgsrc-20xxQy' (Yay! Now `The pkgsrc guide' should be ready for the next century!).
2017-11-26guide: update versioned dependencies examplewiz1-2/+2
2017-09-28doc/guide: Use the new syntax for `regen-doc:' commit messageleot1-2/+2
Add a `doc/pkgsrc.*: ' prefix to the regen commit message to follow the pkgsrc Commit Message Policy.
2017-09-28doc/guide: Adjust ${MASTER_SITE_LOCAL} URI in a comment to make it ↵leot1-2/+2
scp(1)-friendly Make the URI of the comment about htdocs-share distfile scp(1)-friendly so that it can be copypasted more easily. NFCI.
2017-09-28Regen htdocs-share for latest pkgsrc entities.leot2-7/+7
Pointed out and thanks to <gdt>!
2017-09-26*: remove qt3 and the packages using it, including KDE3wiz1-3/+2
Announced in https://mail-index.netbsd.org/pkgsrc-users/2017/09/10/msg025556.html
2017-09-26omit outdated stuff (kde)maya1-11/+1
pointed out by shalokshalom.
2017-09-18Commit message policy: increase summary line length to 65.wiz1-2/+2