os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
45943 commits 1 branch 79 tags 298 MiB
Commit graph

88 commits

Author SHA1 Message Date
Allan Jude
84aa1e4310 Update PR article to ask people not to submit PRs about outdated ports 
PR:		194721
Differential Revision:	https://reviews.freebsd.org/D2092
Submitted by:	marino (original)
Reviewed by:	wblock, Andrew Berg (earlier version)
Approved by:	bcr (mentor)
Sponsored by:	ScaleEngine Inc.
 2015-03-22 19:28:18 +00:00
Eitan Adler
13ba1d0039 Things are different in the bugzilla world. Partly update the 
problem-reports article for this.

This isn't complete but at least provides a better starting point.
 2014-06-29 07:40:14 +00:00
Eitan Adler
7b7c822aba - We no longer have BIND in base. 2014-06-29 07:40:13 +00:00
Glen Barber
4a4ba223dc Replace query-pr.cgi and send-pr.html with their Bugzilla 
equivalents.

Sponsored by:	The FreeBSD Foundation
 2014-06-18 13:41:03 +00:00
Warren Block
62f6c11463 Update the Problem Reports article, adding techniques for followup when 
a PR has been untouched for a while.  Modified version of patch included
with PR.

PR:		docs/190593
Submitted by:	ports@robakdesign.com
 2014-06-03 23:21:48 +00:00
Warren Block
556ade1365 Whitespace-only fixes, translators please ignore. 2014-03-13 04:15:32 +00:00
Warren Block
4aeb075af2 Fix numerous style problems, remove many uses of "you" and "your" 
(leaving only a few thousand), kinda sorta maybe remove some instances
of passive voice, remove and reduce repeated redundancy, add some IDs to
sections.
 2014-03-13 03:28:47 +00:00
Warren Block
c4b1e609e0 Restore <replaceable> tags and some other attributes that were lost in 
the DocBook 5 conversion.
 2014-03-13 03:00:53 +00:00
Hiroki Sato
8def749c53 Normalize DTD URL. 2013-11-13 07:52:45 +00:00
Gabor Kovesdan
24d129e8d1 - Definitively upgrade to DocBook 5.0 2013-11-07 15:39:28 +00:00
Gabor Kovesdan
4a47cdca9b - Enable indexes by default; now they are not so difficult to generate 2013-07-24 19:38:10 +00:00
Gabor Kovesdan
a06603e1e8 - MFH 2013-02-05 09:14:34 +00:00
Gabor Kovesdan
5df509eaa2 - Remove standalone="no" statements from XML declarations since it did not 
always work and is no use anyway
 2013-01-30 19:12:36 +00:00
Gabor Kovesdan
36cdb51546 - Migrate the documentation set to DocBook 4.5 2013-01-30 14:00:53 +00:00
Eitan Adler
de213994c7 Discourage feature requests from the existing GNATS implementation. 
This may change in the future, but they do not get acted upon now.

Remove the alpha category as we no longer support such hardware.

Approved by:	bcr
 2012-10-04 14:56:43 +00:00
Eitan Adler
5dce6e000a Get ready for a world without cvsup and CVS. While this won't happen 
for some time it isn't a good idea to leave these references
lying around

Approved by:	bcr
 2012-10-04 14:56:37 +00:00
Gabor Kovesdan
77d737ee88 - Rename the share/sgml directories to share/xml 
- Fix build errors from the next change

Approved by:	doceng (implicit)
 2012-10-01 11:56:00 +00:00
Gabor Kovesdan
b4346b9b2d - Rename .sgml files to .xml 
- Reflect the rename in referencing files

Approved by:	doceng (implicit)
 2012-10-01 09:53:01 +00:00
Gabor Kovesdan
9c243757ef - XML declarations should use IANA encoding names 
Pointed out by:	hrs
 2012-09-14 17:47:48 +00:00
Gabor Kovesdan
0421ffc179 - MFH 
Approved by:	doceng (implicit)
 2012-09-04 21:35:17 +00:00
Gabor Kovesdan
2e51ec7022 - Strip unnecessary trailing spaces 
Approved by:	doceng (implicit)
 2012-08-21 19:16:02 +00:00
Gabor Kovesdan
e6b69c3357 - XMLify English articles 
Approved by:	doceng (implicit)
 2012-06-21 16:01:00 +00:00
Gabor Pali
6fb170b309 - Spelling fixes 
PR:		docs/149140
Submitted by:	olgeni
 2010-07-31 11:06:18 +00:00
Remko Lodder
a157796182 Add some extra details to the article. 
One whitespace move, because area was touched by
submitter.

PR:		130039
Submitted by:	gavin
 2008-12-30 08:24:54 +00:00
Remko Lodder
a38313ad0b Final pass at making things right, because I didn't check properly. 
Update all url's from the first commit that I did today to have
a space before the <link> and remove the space from within the link
so that it just looks good.

pointy hat:	remko
noticed by:	danger
 2008-07-13 14:37:24 +00:00
Remko Lodder
33b990f6a0 s/http://www.freebsd.org/&url.base;/ 
Noticed by:	simon
 2008-07-13 14:33:36 +00:00
Remko Lodder
10b33657b5 Fix weird spacing [1] and reword the line before it a bit better. 
Spotted by:	danger [1]
 2008-07-13 14:30:35 +00:00
Remko Lodder
bccf5d092b Clarify that we need to use the brackets, and update the web page references 
with actual links. [1]

Also s/submittal/submission/ (changed by myself)

PR:			123043 [1]
Submitted by:		Lawrence Mayer <lawmay3 at i12 dot com> [1]
 2008-07-13 14:04:34 +00:00
Gabor Kovesdan
c5c8eb4b29 - Fix grammar by adding a preposition 
PR:		docs/124016
Submitted by:	Sahil Tandon <sahil@tandon.net>
 2008-05-28 00:36:07 +00:00
Mark Linimon
6af63593ba Add arm category; add missing reference to amd64 category. 2008-04-23 09:30:01 +00:00
Mark Linimon
8662cebce9 Add text that explains the GNATS categories, starting with the most 
important ones and working down.  The mere list was not clear enough.

Glanced over by:	simon
 2008-02-03 08:54:34 +00:00
Mark Linimon
fede914c9e Whitespace change for following text changes: translators please ignore. 2008-02-03 07:43:39 +00:00
Mark Linimon
80ad42a8b0 Minor changes to get ready to import some new text: add link to 
contributing-ports; correctly use example tags; no longer recommend
the advocacy category; remove some text that will become duplicated.
 2008-02-03 07:41:55 +00:00
Marc Fonvieille
d2ed1184e5 SGML fixes: don't use block elements as inline ones, this leads to 
a "weird" rendering.
 2007-04-14 13:33:44 +00:00
Pav Lucistnik
f5a0529523 Update locations of recently moved ports, like portupgrade, portaudit or 
portlint.  I have retained their historical locations in papers which got
written, but are not constantly updated like the rest of our documentation.
 2007-02-05 01:33:20 +00:00
Marc Fonvieille
6740f7351a Add a missing closing tag. 
PR:		docs/103229
Submitted by:	Hiroo Ono <hiroo@oikumene.gcd.org>
 2006-09-13 17:03:53 +00:00
Joel Dahl
f361f5a935 Expand contractions. 2006-02-07 21:32:42 +00:00
Ceri Davies
1d9be2069a s/neccesarily/necessarily/ 2005-10-23 15:27:50 +00:00
Mark Linimon
aac5efa2a6 Claim co-authorship of this, so that the blame for the last several changes 
can be assigned to the appropriate mbox.

Approved by:	original author
 2005-10-22 08:15:34 +00:00
Mark Linimon
c9a087a388 Major additions of text to this article: 
- continue to add more information that is specific to the web-based
   form as opposed to send-pr(1).  In particular, mention problems that
   are particular to that method.

 - greatly expand the text sections about various fields such as
   'categories' to try to adddress continuing misunderstanding on
   the part of our users.

 - discuss the fact that spammers will most likely find your email
   address from a GNATS submission.

 - demote kernel panics to 'serious' to represent commonly accepted
   usage.  Reserve 'critical' for data corruption issues or things that
   would be considered 'showstoppers' for an upcoming release.  (I am
   using my bugmeister hat for this change.)

 - reiterate that serious security problems should go to secteam, not
   into GNATS.

 - document the common problems seen when submitting PRs, including
   our anti-spam measures and the 'lost PR' index problem.

 - deprecate the use of HTML-only messages.  Regression testing using
   the spam filters shows that close to 100% of such messages are spam.
   (The filters have been tuned to correctly pass HTML that is included
   in patches but reject HTML that conforms to all the common abuse
   patterns.  I am using my bugmeister hat for this change).
 2005-10-22 07:03:20 +00:00
Mark Linimon
250212cee2 Swap ordering of field descriptions around for some upcoming work. 
No text changes.
 2005-10-22 04:35:47 +00:00
Mark Linimon
7229e96488 Rewrite all the text about which problems are really FreeBSD problems and 
which are problems with code that is merely incorporated into FreeBSD.  In
particular, the original article was written from the standpoint of src/;
these changes put ports/ on an equal basis.  Finally, cross-reference the
src/ versions that secteam supports.
 2005-10-20 08:07:08 +00:00
Mark Linimon
b763b48719 Move a block of text in preparation for it being rewritten. Translators 
note: this is a copy with no text change (yet).
 2005-10-20 07:59:34 +00:00
Mark Linimon
31360fdce5 Add new text about avoiding email mangling; about backing up your work 
before you submit; and considerations of when a PR is "too large".
 2005-10-20 06:45:47 +00:00
Mark Linimon
06df39fac3 Clarify that send-pr is not the only submission technology. 2005-10-20 06:31:09 +00:00
Mark Linimon
624ab6d711 Move two sentences a little bit later in 'when to submit' and slightly modify 
the first one.  This is part of a larger set of changes that are coming.
 2005-10-20 06:28:37 +00:00
Remko Lodder
30e46046f2 Make the PR followup address easier to maintain by adding an entity to 
the mailing-lists.ent file (though it's not really an mailinglist).
Also replace the current follow up addresses by it's entity name.

Submitted by:		ceri
 2005-08-13 21:17:05 +00:00
Jesus R. Camou
b18d432e58 Document what to do if an outdated port 
is noticed.

PR:		docs/80681
Submitted by:	Roman Neuhauser <neuhauser@sigpipe.cz>
		Ion-Mihai Tetcu <itetcu@people.tecnik93.com>
Approved by:	trhodes (mentor)
 2005-07-19 21:37:15 +00:00
Mark Linimon
f46cec4513 Add the 'usb' PR category. While here, clarify the use of the 'java' 
category and change the master list of categories to point the CVSweb
location, which should always have the latest list.

Spurred by email from:		obrien
 2005-01-15 02:16:42 +00:00
Hiroki Sato
c4cb2201ad Use lower-case characters for attribute name (s/URL=/url=/). 
No content change.
 2004-08-09 19:49:18 +00:00