From shammer@daemon.li  Wed Aug 13 05:00:42 2003
Return-Path: <shammer@daemon.li>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 9453337B49A
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 13 Aug 2003 05:00:41 -0700 (PDT)
Received: from mail.ac-net.at (secure.ac-net.at [212.24.125.8])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 951F443F75
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 13 Aug 2003 05:00:40 -0700 (PDT)
	(envelope-from shammer@daemon.li)
Received: from localhost (server.ac-net.at [127.0.0.1])
	by mail.ac-net.at (AC-net Mailserver v1.3a) with ESMTP id 1070B3FF0
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 13 Aug 2003 14:00:33 +0200 (CEST)
Received: from daemon.li (dsl-237-37.utaonline.at [212.152.237.37])
	by mail.ac-net.at (AC-net Mailserver v1.3a) with SMTP id 269D13F8C
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 13 Aug 2003 12:00:30 +0000 (UTC)
Received: (qmail 3244 invoked from network); 13 Aug 2003 12:02:32 -0000
Received: from localhost (HELO daemon.li) (127.0.0.1)
  by localhost with SMTP; 13 Aug 2003 12:02:32 -0000
Received: (from shammer@localhost)
	by daemon.li (8.12.6/8.12.7/Submit) id h7DC2V9B003242;
	Wed, 13 Aug 2003 14:02:32 +0200 (CEST)
	(envelope-from shammer)
Message-Id: <200308131202.h7DC2V9B003242@daemon.li>
Date: Wed, 13 Aug 2003 14:02:32 +0200 (CEST)
From: Josef El-Rayes <j.el-rayes@daemon.li>
Reply-To: Josef El-Rayes <j.el-rayes@daemon.li>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] add screenshots to desktop chapter
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         55538
>Category:       docs
>Synopsis:       [patch] add screenshots to desktop chapter
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Wed Aug 13 05:10:14 PDT 2003
>Closed-Date:    Thu Jan 15 14:18:54 PST 2004
>Last-Modified:  Thu Jan 15 14:18:54 PST 2004
>Originator:     Josef El-Rayes
>Release:        FreeBSD 4.8-STABLE i386
>Organization:
>Environment:
System: FreeBSD daemon.li 4.8-STABLE FreeBSD 4.8-STABLE #8: Tue Jul 22 18:16:23 CEST 2003 root@daemon.li:/usr/obj/usr/src/sys/CUSTOM i386


	
>Description:
		doc/en_US.ISO8859-1/books/handbook/x11/chapter.sgml:
                i added two screenshots showing a kde and a freebsd desktop
                because i think it is necessary to not only talk but also
                show how these desktop actually "look". i have not seen a
                single book or article about wm/desktops without images yet.
                                                                                                                      
                the images are available at:
                http://www.daemon.li/downloads/gnomedesktop.png
                http://www.daemon.li/downloads/kdedesktop.png
                                                                                                                      
                the gnomedesktop screenshot is taken from the gnome/freebsd
                site and the kde desktop screenshot belongs to
                arved@freebsd.org.

	
>How-To-Repeat:
	
>Fix:

	

--- chapter.sgml.diff begins here ---
--- chapter.sgml.orig	Wed Aug 13 12:56:47 2003
+++ chapter.sgml	Wed Aug 13 13:35:08 2003
@@ -1211,6 +1211,16 @@
 	  FreeBSD can be found on the <ulink
 	  url="http://www.FreeBSD.org/gnome">FreeBSD GNOME
 	  Project</ulink>'s web site.</para>
+
+	  <figure id="x11-wm-gnome-screenshot">
+	    <title>GNOME Desktop Screenshot</title>
+	    <mediaobject>
+	      <imageobject>
+		<imagedata fileref="x11/gnomedesktop" format="PNG">
+	      </imageobject>
+	    </mediaobject>
+	  </figure>
+	  <para>A screenshot featuring the GNOME Desktop(<xref linkend="x11-wm-gnome">).</para>
       </sect3>
 
       <sect3 id="x11-wm-gnome-install">
@@ -1363,6 +1373,16 @@
 	  resources on <application>KDE</application>, consult
 	  the <ulink url="http://freebsd.kde.org/">FreeBSD-KDE
 	  team</ulink>'s website.</para>
+
+	  <figure id="x11-wm-kde-screenshot">
+	    <title>KDE Desktop Screenshot</title>
+	    <mediaobject>
+	      <imageobject>
+		<imagedata fileref="x11/kdedesktop" format="PNG">
+	      </imageobject>
+	    </mediaobject>
+	  </figure>
+	  <para>A screenshot featuring the KDE Desktop(<xref linkend="x11-wm-kde">).</para>
       </sect3>
 
       <sect3 id="x11-wm-kde-install">
--- chapter.sgml.diff ends here ---

--- Makefile.diff begins here ---
--- Makefile.orig	Wed Aug 13 13:03:49 2003
+++ Makefile	Wed Aug 13 13:05:39 2003
@@ -110,6 +110,8 @@
 IMAGES_EN+= vinum/vinum-simple-vol.pic
 IMAGES_EN+= vinum/vinum-striped-vol.pic
 IMAGES_EN+= vinum/vinum-striped.pic
+IMAGES_EN+= x11/gnomedesktop.png
+IMAGES_EN+= x11/kdedesktop.png
 
 # Images from the cross-document image library
 IMAGES_LIB=  callouts/1.png
--- Makefile.diff ends here ---


>Release-Note:
>Audit-Trail:

From: Tilman Linneweh <tilman@arved.de>
To: Josef El-Rayes <j.el-rayes@daemon.li>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/55538: [patch] add screenshots to desktop chapter
Date: Wed, 13 Aug 2003 16:06:28 +0200

 * Josef El-Rayes [Mi, 13 Aug 2003 at 14:10 GMT]:
 >>Description:
 > 		doc/en_US.ISO8859-1/books/handbook/x11/chapter.sgml:
 >                 i added two screenshots showing a kde and a freebsd desktop
 >                 because i think it is necessary to not only talk but also
 >                 show how these desktop actually "look". i have not seen a
 >                 single book or article about wm/desktops without images yet.
 >                                                                                                                       
 >                 the images are available at:
 >                 http://www.daemon.li/downloads/gnomedesktop.png
 >                 http://www.daemon.li/downloads/kdedesktop.png
 
 No, I don't like them. The GNOME one has a mixture of German and English on it
 and a strange font. The KDE one doesn't show specific KDE Applications and contains
 lots of German texts too. The KDE-FreeBSD Website has many better KDE Screenshots.
 Please submit some more default-style Screenshots.
 
 Second I don't think that the Handbook should be a screenshot gallery.

From: Josef El-Rayes <j.el-rayes@daemon.li>
To: Tilman Linneweh <tilman@arved.de>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/55538: [patch] add screenshots to desktop chapter
Date: Wed, 13 Aug 2003 16:57:26 +0200

 Tilman Linneweh <tilman@arved.de> wrote:
 > No, I don't like them. The GNOME one has a mixture of German and English on it
 > and a strange font. The KDE one doesn't show specific KDE Applications and contains
 > lots of German texts too. The KDE-FreeBSD Website has many better KDE Screenshots.
 > Please submit some more default-style Screenshots.
 i will try to find more suitable screenshots according to your
 definitions.
 
 > Second I don't think that the Handbook should be a screenshot gallery.
 i think "screenshot gallery" is a bit exaggerated. as i only want to
 provide one screenshot to give the user an impression, of what we are
 actually talking about.
 a picture says more than words and when talking about desktop
 environments it is essential to show how it looks like.
 why do we provide screenshots of sysinstall in the install chapter? 
 to support the text, so why do not add 1 screenshot per desktop
 environment? i will provide another pair of screenshots tomorrow.
 
 greets, josef 
 -- 
 www: http://www.daemon.li
 nic-hdl: JER1080312-NICAT
 BSD in AT: www.bsdcode.at
 "Make World - Not War!"

From: Marc Fonvieille <blackend@FreeBSD.org>
To: Josef El-Rayes <j.el-rayes@daemon.li>
Cc: freebsd-doc@FreeBSD.org, FreeBSD-gnats-submit@FreeBSD.org,
	tilman@arved.de
Subject: Re: docs/55538: [patch] add screenshots to desktop chapter
Date: Wed, 13 Aug 2003 17:25:15 +0200

 On Wed, Aug 13, 2003 at 08:00:37AM -0700, Josef El-Rayes wrote:
 > The following reply was made to PR docs/55538; it has been noted by GNATS.
 > 
 > From: Josef El-Rayes <j.el-rayes@daemon.li>
 > To: Tilman Linneweh <tilman@arved.de>
 > Cc: FreeBSD-gnats-submit@freebsd.org
 > Subject: Re: docs/55538: [patch] add screenshots to desktop chapter
 > Date: Wed, 13 Aug 2003 16:57:26 +0200
 > 
 >  Tilman Linneweh <tilman@arved.de> wrote:
 >  > No, I don't like them. The GNOME one has a mixture of German and English on it
 >  > and a strange font. The KDE one doesn't show specific KDE Applications and contains
 >  > lots of German texts too. The KDE-FreeBSD Website has many better KDE Screenshots.
 >  > Please submit some more default-style Screenshots.
 >  i will try to find more suitable screenshots according to your
 >  definitions.
 >  
 >  > Second I don't think that the Handbook should be a screenshot gallery.
 >  i think "screenshot gallery" is a bit exaggerated. as i only want to
 >  provide one screenshot to give the user an impression, of what we are
 >  actually talking about.
 >  a picture says more than words and when talking about desktop
 >  environments it is essential to show how it looks like.
 
 In that section, links to the FreeBSD GNOME Project and to the
 FreeBSD-KDE team's web sites were added also for that purpose.  These
 sites provide screenshots and many informations.  It would be useless to
 "re-invent" the wheel. (look at
 http://www.freebsd.org/gnome/screenshots.html for example).
 
 >  why do we provide screenshots of sysinstall in the install chapter? 
 >  to support the text, so why do not add 1 screenshot per desktop
 >  environment? i will provide another pair of screenshots tomorrow.
 
 The case is different, it's really difficult to talk about various
 Sysinstall steps without some screenshots.  And Sysinstall is a part of
 FreeBSD, GNOME and KDE are third party softwares, it's not the aim of
 our documentation to provide screenshots of every apps around, links are
 provided for that purpose.
 We already talked about that "screenshot problem" about one year ago,
 and with the same conclusion.
 
 Marc
State-Changed-From-To: open->closed 
State-Changed-By: josef 
State-Changed-When: Thu Jan 15 14:16:14 PST 2004 
State-Changed-Why:  
This one can be closed, the originator said. 

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