ports/79235: [maintainer update] sysutils/dtc: v0.17.0.3 of Domain Technologie Control (DTC) web hosting control panel

[Mark Linimon]

On Sun, 10 Apr 2005, Thomas GOIRAND wrote:

>  first I want you to know I feel terribly sorry I didn't follow the
>  guidelines.

It's not a terrible problem, so there is no reason to feel particularly
sorry -- it's just that it requires extra handling to reformat.  GNATS
is very particular about the data that it receives.

> I'm not sure I understood, because I don't see any feild named "category".

By this I'm trying to imply that rather than

  Synopsis: update DTC web hosting control panel

we prefer

  Synopsis: update sysutils/dtc

With the literal category and literal portname in the Synopsis, it is
easier to identify which port the PR is for.  Since we are approaching
our 13,000th port this help is appreciated :-)

> I think it would be nice if you add a section on port submitting in
> the doc (category section), saying all what should be done, maybe
> it's a bit confusing for a FreeBSD newbie like me.

The following chapter of the 'Submitting a PR document' tries to be
specific about this:

http://www.freebsd.org/doc/en_US.ISO8859-1/articles/problem-reports/article.html#PR-WRITING

> About the wrap to 70 chars, I was really sorry I did it too, I just
> didn't know it wouldn't do the line breaks, and I couldn't change it
> after submitting could I?

No, only a FreeBSD committer can edit the PRs once they have been sent,
but I have already gone back and reformatted it.  (Don't worry, this is
a fairly common occurence).  While all the information is there, it
just makes it harder to read when using edit-pr or reading the report's
page in a web browser.

I will try to make a note to myself to add a comment about line wrapping
to this documentation after the docs freeze for 5.4 is lifted.

mcl