From dom@host213-123-130-182.in-addr.btopenworld.com  Mon Apr 15 01:38:00 2002
Return-Path: <dom@host213-123-130-182.in-addr.btopenworld.com>
Received: from host213-123-130-182.in-addr.btopenworld.com (host213-123-130-182.in-addr.btopenworld.com [213.123.130.182])
	by hub.freebsd.org (Postfix) with ESMTP
	id 1FFC237B41A; Mon, 15 Apr 2002 01:38:00 -0700 (PDT)
Received: by host213-123-130-182.in-addr.btopenworld.com (Postfix, from userid 1001)
	id ABA694E8; Mon, 15 Apr 2002 09:38:24 +0100 (BST)
Message-Id: <20020415083824.ABA694E8@host213-123-130-182.in-addr.btopenworld.com>
Date: Mon, 15 Apr 2002 09:38:24 +0100 (BST)
From: Dominic Marks <dominic_marks@btinternet.com>
Reply-To: Dominic Marks <dominic_marks@btinternet.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc: jdp@freebsd.org
Subject: Port: net/cvsup depends on X11
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         37089
>Category:       ports
>Synopsis:       Port: net/cvsup depends on X11
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-ports
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Apr 15 01:40:01 PDT 2002
>Closed-Date:    Tue Apr 16 21:20:07 PDT 2002
>Last-Modified:  Tue Apr 16 21:20:07 PDT 2002
>Originator:     Dominic Marks
>Release:        FreeBSD 4.5-STABLE i386
>Organization:
Student
>Environment:
System: FreeBSD gallium 4.5-STABLE FreeBSD 4.5-STABLE #2: Mon Apr 8
21:19:28 BST 2002 dom@gallium:/usr/obj/usr/src/sys/GALLIUM i386

	
>Description:
	The net/cvsup port depends on X11. I am aware that there are
	options to disable X11, and that there is a port called
	cvsup-without-gui.

	Despite these measures, I have seen, as someone who regularly
	helps newbies to FreeBSD, that this has been the #1 source of
	post-install problems. The general path is:

	1. Read the handbook
	2. Installed CVSup
	3. Copied the example supfile and modified it
	4. Attempted to use cvsup my-supfile
	5. Failed because cvsup requires libXaw

	Just this morning:

	<zhamrock> need help on this /usr/libexec/ld-elf.so.1: Shared object
	"libXaw.so.6" not found
	<dom> your trying to run cvsup right
	<zhamrock> yup
	<dom> zhamrock: pkg_delete cvsup
	<dom> pkg_add cvsup-without-gui
	<zhamrock> ok

	I would like to ask on their behalf that the ports are moved like
	so:

	net/cvsup => net/cvsup-with-gui
	net/cvsup-without-gui => net/cvsup

	
>How-To-Repeat:
	Stay in any FreeBSD help IRC channel for an hour or two.
	
>Fix:
	Swap the CVSup ports around so people have to go out of their way to
	shoot themselves in the foot.
	
	Alternatively make the net/cvsup port depend on X11 - although this
	will mean a lot of newbies will then end up installing X11 when they
	don't need it.

	Lastly it is possible to add notes to all the documentation with
	mentions CVSup warning about this issue. (I am willing to do this if
	there is a consensus for keeping the ports as they are).

	I think the first option is simplest. Thanks!
	


>Release-Note:
>Audit-Trail:

From: Dominic Marks <dominic_marks@btinternet.com>
To: FreeBSD-gnats-submit@FreeBSD.org, freebsd-ports@FreeBSD.org
Cc: jdp@freebsd.org
Subject: Re: ports/37089: Port: net/cvsup depends on X11
Date: Tue, 16 Apr 2002 12:58:18 +0100

 On Mon, Apr 15, 2002 at 01:40:02AM -0700, FreeBSD-gnats-submit@FreeBSD.org wrote:
 > Thank you very much for your problem report.
 > It has the internal identification `ports/37089'.
 > The individual assigned to look at your
 > report is: freebsd-ports. 
 > 
 > You can access the state of your problem report at any time
 > via this link:
 > 
 > http://www.freebsd.org/cgi/query-pr.cgi?pr=37089
 > 
 > >Category:       ports
 > >Responsible:    freebsd-ports
 > >Synopsis:       Port: net/cvsup depends on X11
 > >Arrival-Date:   Mon Apr 15 01:40:01 PDT 2002
 
 Here are some diffs.
 
 This one adds a note to the CVSup section of the Handbook warning
 about installing the wrong CVSup for your needs.
 
 Index: chapter.sgml
 ===================================================================
 RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml,v
 retrieving revision 1.208
 diff -u -r1.208 chapter.sgml
 --- chapter.sgml	2002/04/12 10:49:45	1.208
 +++ chapter.sgml	2002/04/16 11:31:37
 @@ -1685,6 +1685,15 @@
  	<filename role="package">net/cvsup</filename> port depends on the Modula-3
  	system, which takes a substantial amount of time and
  	disk space to download and build.</para>
 +
 +	<note>
 +	  <para>If you are going to be using
 +	  <application>CVSup</application> on a machine which will not have
 +	  <application>XFree86</application> installed, such as a server, be
 +	  sure to use the port which does not include the
 +	  <application>CVSup</application> <acronym>GUI</acronym>, <filename
 +	  role="package">net/cvsup-without-gui</filename>.</para>
 +	</note>
        
        <para>If you do not know anything about 
  	<application>CVSup</application> at all and want a
 
 This next one adds a section to the networking section of the FAQ
 about the sort of error you can expect to see if the wrong CVSup has
 been installed.
 
 Index: book.sgml
 ===================================================================
 RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v
 retrieving revision 1.427
 diff -u -r1.427 book.sgml
 --- book.sgml	2002/04/11 21:31:10	1.427
 +++ book.sgml	2002/04/16 11:54:39
 @@ -8941,6 +8941,34 @@
              performance of your FreeBSD machine.</para>
          </answer>
        </qandaentry>
 +
 +	  <qandaentry>
 +	  	<question id="cvsup-missing-libs">
 +		  <para>I've just installed CVSup but trying to execute it
 +		  produces errors, what is wrong?</para>
 +		</question>
 +		<answer>
 +		  <para>First make sure the error message that you are
 +		  receiving is like the one shown below.</para>
 +
 +		  <programlisting>/usr/libexec/ld-elf.so.1: Shared object "libXaw.so.6" not found</programlisting>
 +
 +		  <para>Errors like these are caused by installing the
 +		  <filename role="package">net/cvsup</filename> port on a
 +		  machine which does not have the
 +		  <application>XFree86</application> suite. If you  want to
 +		  use the <acronym>GUI</acronym> included with
 +		  <application>CVSup</application> you will need to install
 +		  <application>XFree86</application> now. Alternatively if you
 +		  just wish to use <application>CVSup</application> from a
 +		  command line you should delete the package previously
 +		  installed. Then install the <filename
 +		  role="package">net/cvsup-without-gui</filename> port. This is
 +		  covered in more detail in the <ulink
 +		  url="http://www.freebsd.org/handbook/cvsup.html">CVSup
 +		  section</ulink> of the Handbook.</para>
 +		</answer>
 +	  </qandaentry>
      </qandaset>
    </chapter>
  
 
 Thanks
 -- 
 Dominic
State-Changed-From-To: open->closed 
State-Changed-By: jdp 
State-Changed-When: Tue Apr 16 21:18:46 PDT 2002 
State-Changed-Why:  
I have committed your revisions to the documentation.  Excellent work! 
Thank you for taking the time to write these changes. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=37089 
>Unformatted:
