Bug 66633

Summary: [PATCH] Java section of the Porter's Handbook
Product: Documentation Reporter: Hervé Quiroz <herve.quiroz>
Component: Books & ArticlesAssignee: Mark Linimon <linimon>
Status: Closed FIXED    
Severity: Affects Only Me CC: linimon
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Hervé Quiroz 2004-05-14 13:20:17 UTC 
Here is the Java section of the Porter's handbook. It is up-to-date regarding
the latest additions of bsd.java.mk 2.0 commited by 4.10-RELEASE.

NOTE: I don't explain anything regarding the JAVA_PREFERRED_PORT variable in
this section.  JAVA_PREFERRED_PORT may be used to specify a preferred JDK port
(amongst the suitable ones) for JDK dependency. It allows the end-user to
override the default behaviour of bsd.java.mk (which tends to use native JDKs).
IMHO, this variable should be documented somewhere though, but probably not in
the Porter's handbook as this information is more relevant for users than
porters.

Greg Lewis is CC'ed (as the commiter of bsd.java.mk 2.0)
Mark Linimon is CC'ed (as he agreed sometime ago to be the reviewer)
Comment 1 Hervé Quiroz 2004-05-14 13:56:04 UTC 
Hum. My e-mail is wrong in this PR. It should be:

herve.quiroz@esil.univ-mrs.fr

I don't know how I got this wrong...

Herve
Comment 2 Mark Linimon freebsd_committer freebsd_triage 2004-05-14 14:15:56 UTC 
Responsible Changed
From-To: freebsd-doc->linimon

I agreed to work on this one earlier.
Comment 3 Hervé Quiroz 2004-05-18 17:56:35 UTC 
Mark,

Is there a way to change my e-mail address in the Originator field of
the PR? As I said earlier, I made a mistake and I can't receive the
follow-ups...

I also realized that some stuff is missing is the document I submitted,
such as:

- Explanation about defined constants (JAVAJARDIR, JAVASHAREDIR...)
- Conventions regarding standard location for Java libraries,
  applications, API docs...

Furthermore, I was also considering adding a subsection called "Best
practices" that explains what a Java porters is expected to do. I could
for instance discuss the source/binary issue, and evocate the 'java' vs
'ports' PR issue we are currently discussing on freebsd-java...

I have enough ideas for the first two items so I'll write up something
soon on the subject.

Herve
Comment 4 Mark Linimon freebsd_committer freebsd_triage 2004-05-21 08:04:27 UTC 
State Changed
From-To: open->closed

Committed, thanks.  We'll work on the new text on the next 
iteration.