From david@catwhisker.org  Sun Sep 14 21:03:28 2003
Return-Path: <david@catwhisker.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id F049816A4BF
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 14 Sep 2003 21:03:27 -0700 (PDT)
Received: from bunrab.catwhisker.org (adsl-63-193-123-122.dsl.snfc21.pacbell.net [63.193.123.122])
	by mx1.FreeBSD.org (Postfix) with ESMTP id CCCEF43F93
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 14 Sep 2003 21:03:24 -0700 (PDT)
	(envelope-from david@catwhisker.org)
Received: from bunrab.catwhisker.org (localhost [127.0.0.1])
	by bunrab.catwhisker.org (8.12.9/8.12.9) with ESMTP id h8F43Ont002032
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 14 Sep 2003 21:03:24 -0700 (PDT)
	(envelope-from david@bunrab.catwhisker.org)
Received: (from david@localhost)
	by bunrab.catwhisker.org (8.12.9/8.12.9/Submit) id h8F43O99002031;
	Sun, 14 Sep 2003 21:03:24 -0700 (PDT)
	(envelope-from david)
Message-Id: <200309150403.h8F43O99002031@bunrab.catwhisker.org>
Date: Sun, 14 Sep 2003 21:03:24 -0700 (PDT)
From: David Wolfskill <david@catwhisker.org>
Reply-To: David Wolfskill <david@catwhisker.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Inadequately-documented charter for freebsd-jobs@
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         56883
>Category:       docs
>Synopsis:       Inadequately-documented charter for freebsd-jobs@
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun Sep 14 21:10:21 PDT 2003
>Closed-Date:    Sat Jan 17 15:49:08 PST 2004
>Last-Modified:  Sat Jan 17 15:49:08 PST 2004
>Originator:     David Wolfskill
>Release:        FreeBSD 4.9-PRERELEASE i386
>Organization:
Wolfskill and Dowling Residence
>Environment:
System: FreeBSD bunrab.catwhisker.org 4.9-PRERELEASE FreeBSD 4.9-PRERELEASE #48: Sun Sep 14 09:05:57 PDT 2003 root@freebeast.catwhisker.org:/common/S1/obj/usr/src/sys/BUNRAB i386

[Eh; that's not relevant; this is against the Handbook.]
>Description:
	Direct the Web browser of your choice to
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/eresources.html#ERESOURCES-MAIL;
note that although there is a one-line summary for freebsd-jobs, there
is not "charter" listed.

This PR was catalyzed by receipt of a message, of which the following is
a relevant excerpt:

>How-To-Repeat:
	Keep looking at the page cited above.  :-)
>Fix:

Index: chapter.sgml
===================================================================
RCS file:
/cvs/freebsd/doc/en_US.ISO8859-1/books/handbook/eresources/chapter.sg
>Release-Note:
>Audit-Trail:

From: Warren Block <wblock@wonkity.com>
To: David Wolfskill <david@catwhisker.org>
Cc: FreeBSD-gnats-submit@freebsd.org, freebsd-doc@freebsd.org
Subject: Re: docs/56883: Inadequately-documented charter for freebsd-jobs@
Date: Mon, 15 Sep 2003 05:23:28 -0600 (MDT)

 On Sun, 14 Sep 2003, David Wolfskill wrote:
 
 >  >We need to add some text to the charter for the jobs@ list.  Please add
 >  >some text encouraging people posting job availability to clearly state
 >  >WHERE the job is available and if relocation will be reimbursed.
 
 >  +	    <para>Note that this list, like other mailing lists
 >  +	      @FreeBSD.ORG, is distributed worldwide.  Thus, you
 
               ^ I think the "@" symbol there should be spelled out
 (you're talking about mailing lists, not specific email addresses, so
 the @ is inappropriate).  The .ORG should probably not be capitalized,
 either:
 
    +	      at FreeBSD.org, is distributed worldwide.  Thus, you
 
 >  +	    <para>All email should be open source formats only.
 >  +	      Examples of open source formats include PostScript
 >  +	      (.ps), Portable Document Format (.pdf) and ASCII text.
 
 A slight rewrite and reorganization from most common to less common:
 
    +        <para>Email must be in open source formats only.  Plain
    +          ASCII text, Portable Document Format (PDF), or PostScript
    +          are appropriate.
 
 (Is PostScript really something that should be mentioned here?  It has
 more interchange issues than either of the others.  I'm also unsure
 whether "open source" is a good description of these formats, but can't
 think of anything better at the moment.)
 
 >  +	      Proprietary formats such as MicroSoft Word (.doc) are
 >  +	      not accepted.</para>
 
 And maybe a change of tense?
 
 >  +          Proprietary formats such as MicroSoft Word (.doc) will
 >  +          not accepted.</para>
 
 -Warren Block * Rapid City, South Dakota USA
State-Changed-From-To: open->closed 
State-Changed-By: simon 
State-Changed-When: Sat Jan 17 15:48:14 PST 2004 
State-Changed-Why:  
Committed with modifications based on review on -doc, and some minor 
stuff by me.  Thanks for the submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=56883 
>Unformatted:
 >To: postmaster@freebsd.org
 >Subject: Change to charter for jobs@ list
 >Date: Sat, 13 Sep 2003 12:25:51 -0700
 
 >We need to add some text to the charter for the jobs@ list.  Please add 
 >some text encouraging people posting job availability to clearly state 
 >WHERE the job is available and if relocation will be reimbursed.
 
 I don't claim to be much of an SGML-hacker, but I think I can follow
 patterns moderately well.  Please consider this a suggestion, and feel
 free to adapt it as appropriate.
 
 >ml,v retrieving revision 1.132
 diff -u -r1.132 chapter.sgml
 --- chapter.sgml	4 Sep 2003 11:38:52 -0000	1.132
 +++ chapter.sgml	13 Sep 2003 22:07:47 -0000
 @@ -914,6 +914,34 @@
  	</varlistentry>
 
  	<varlistentry>
 +	  <term>&a.jobs.name;</term>
 +
 +	  <listitem>
 +	    <para><emphasis>Jobs offered and sought</emphasis></para>
 +
 +	    <para>This is a forum for posting employment notices
 +	      and resumes specifically related to FreeBSD, e.g. if
 +	      you're seeking FreeBSD-related employment or have a job
 +	      involving FreeBSD to advertise then this is the right
 +	      place.  This is NOT a mailing list for general employment
 +	      issues since adequate forums for that already exist
 +	      elsewhere.</para>
 +
 +	    <para>Note that this list, like other mailing lists
 +	      @FreeBSD.ORG, is distributed worldwide.  Thus, you
 +	      need to be clear about location and the extent to
 +	      which telecommuting or assistance with relocation is
 +	      available.</para>
 +
 +	    <para>All email should be open source formats only.
 +	      Examples of open source formats include PostScript
 +	      (.ps), Portable Document Format (.pdf) and ASCII text.
 +	      Proprietary formats such as MicroSoft Word (.doc) are
 +	      not accepted.</para>
 +	  </listitem>
 +	</varlistentry>
 +
 +	<varlistentry>
  	  <term>&a.kde.name;</term>
 
  	  <listitem>
 
