Subversion Primer
- Clarify 'FreeBSD=%H' is the 'svn:keywords' property that is set
- Replace a ulink with an xref to the new section id
Suggested by: gavin
repository conversion:
- Replace "Main Subversion Root" with "src/ Subversion Root", and add
and equivalent entry for the doc/ tree root
- Replace "Main CVSROOTs" with "ports/ CVS Root" and remove the listing
for the doc/ CVS tree
- Specify the src/ tree in a listing of noteworthy branches
- Update an example to use "pcvs" instead of "dcvs"
CVS->SVN conversion:
- Remove references of 'dcvs' from the VCS Operations Guide
- Fix the date the src tree was moved from CVS->SVN while here
- Add the date the doc CVS->SVN conversion was officially complete
- Add doc-specific notes to the Subversion primer
- Document that, though the Subversion Primer is written with the src
tree in mind, the underlying concepts are the same
exist. (My fault for not noticing this section does not exist when
originally committing this.)
Submitted/patched by: Isabell Long (isabell121%gmail!com)
This work was done as part of Google Code-In (GCIN) 2011.
GCIN student: Isabell Long (isabell121 gmail com)
GCIN task mentors: des, rea
Minor rewriting by: gjb (myself) [1]
[1] The original task was to put this in the Developers' Handbook,
but as discussed with des, the CVS information is in the Committers'
guide; the Subversion Primer entry likely belongs here as well.
- Specifically add a step for 'cvs add' of the new files
- Group related steps (category/Makefile, MOVED, LEGAL),
and suggest committing it all in one go.
While here peform some other minor tweaks to wording
- Force column width to improve rendering.
- Remove a number of pieces of information which is either obsolete or
just not important. This includes removing reference to using telnet
which was already obsolete when I got a commit bit in 2003...
- Point people at freefall.
- Remove the hardcoded lists of members of cvsadm and GNATS admins -
this just duplicated administration.html and new committers should
not need to bug the two teams so often that they need to be pointed
out more than the many other active administrative teams. [1]
- Point at dcvs and pcvs for CVS repo's, as those are still in use by
developers.
- Don't use entities for internal mailing lists which expands to the
names as the result is just confusing and not useful. This part
should probably be changed to be a section with more text instead of
trying to include most info inside a table.
- Add information about portmgr monthly reports.
- Add a few links to some useful internal pages with more information.
- Misc minor text cleanup.
Discussed with: linimon, gavin [1]
said project is now long since completed, and there are enough people
with SMP-fu around that there's no need to point everybody at a single
target.
No objection from: jhb
* mention svn-arc-all along with cvs-all, the latter is not applicable for src
* update to 2010
Approved by: hrs, philip (mentor)
No screaming: keramida
