! Please note that this is a snapshot of our old Bugzilla server, which is read only since May 29, 2020. Please go to gitlab.xfce.org for our new server !
doc (code) improvements
Status:
RESOLVED: INVALID
Severity:
trivial
Product:
Xfce4-appfinder
Component:
General

Comments

Description Matthias Krüger 2008-07-08 10:19:43 CEST
User-Agent:       Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.8.1.14) Gecko/20080404 Iceweasel/2.0.0.14 (Debian-2.0.0.14-2)
Build Identifier: 

I noticed that the file file:///usr/share/xfce4/doc/C/xfce4-appfinder.html was not valid. Even a doctype was missing.

Reproducible: Always

Steps to Reproduce:
1. go to http://validator.w3.org/#validate_by_input
2. copy the content of the file /usr/share/xfce4/doc/C/xfce4-appfinder.html into the white field
3. press "check"
Actual Results:  
The validator said:
This page is not Valid (no Doctype found)!
Result: 	Failed validation, 4 Errors

Expected Results:  
The validator should have said:
"This Page Is Valid XHTML 1.0 Strict!
Result:         Passed validation"

I made a patch:

/usr/share/xfce4/doc/C/xfce4-appfinder.html:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
  <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"/>
  <title>Xfce 4 Appfinder</title>
  <link rel="stylesheet" href="../xfce.css" type="text/css"/>
  <meta name="generator" content="DocBook XSL Stylesheets V1.68.1"/>
  <link rel="start" href="#xfce4-appfinder" title="Xfce 4 Appfinder"/>
  <link rel="next" href="#appfinder-intro" title="Introduction"/>
 </head>
 <body>
  <div class="article" lang="en">
   <div class="titlepage">
    <div>
     <div>
      <h1 class="title">
       <a name="xfce4-appfinder"></a>Xfce 4 Appfinder
      </h1>
     </div>
     <div>
      <div class="authorgroup">
       <div class="author">
        <h3 class="author">
         <span class="firstname">Eduard</span>
         <span class="surname">Roccatello</span>
        </h3>
        <div class="affiliation">
         <div class="address"> 
          <p>
           <code class="email">&lt;<a href="mailto:eduard@xfce.org">eduard@xfce.org</a>&gt;</code>
          </p>
         </div>
        </div>
       </div>
      </div>
     </div>
      <div>
       <span  class="releaseinfo">This manual describes <strong  class="application"><code>xfce4-appfinder</code></strong> version 4.2. Last updated: November 2004
        <br/>
       </span>
      </div>
      <div>
       <p class="copyright">Copyright © 2004 Eduard Roccatello</p>
      </div>
     </div>
    <hr/>
    </div>
    <div class="toc">
     <p>
      <b>Table of Contents</b>
     </p>
     <dl>
      <dt>
       <span class="sect1">
        <a href="#appfinder-intro">Introduction</a>
       </span>
      </dt>
      <dt>
       <span class="sect1">
        <a href="#appfinder-getting-started">Getting Started</a>
       </span>
      </dt>
      <dt>
       <span class="sect1">
        <a href="#appfinder-advanced">Appfinder Advanced features</a>
       </span>
      </dt>
      <dt>
       <span class="sect1">
        <a href="#appfinder-copyright">About <strong class="application">
         <code>xfce4-appfinder</code></strong>
        </a>
       </span>
      </dt>
     </dl>
    </div>
    <p>
    </p>
    <div class="sect1" lang="en">
     <div class="titlepage">
      <div>
       <div>
        <h2 class="title" style="clear: both">
         <a name="appfinder-intro">
          </a>Introduction
        </h2>
       </div>
      </div>
     </div>
     <p>
     The Xfce 4 Appfinder is part of the <a href="http://www.xfce.org">Xfce 4 Desktop Environment</a> and features application
       search on the whole system. It searches for 
       <code class="filename">.desktop</code> files based on the
       freedesktop spec and makes an index of the found apps.</p>
    </div>
    <p>
    </p>
    <div class="sect1" lang="en">
     <div class="titlepage">
      <div>
       <div>
        <h2 class="title" style="clear: both">
         <a name="appfinder-getting-started">
         </a>Getting Started
        </h2>
       </div>
      </div>
     </div>
     <p>You can start Appfinder from console running 
      <span>
       <strong class="command">xfce4-appfinder</strong>
      </span> command or launching
   it through panel launcher icon.
     </p>
     <p>
     When you start the appfinder you will see a window appearing center
     of your screen, looking like this:
     </p>
     <div class="figure">
      <a name="default-appfinder-fig"></a>
      <p class="title">
       <b>Figure 1. Xfce4 Appfinder</b>
      </p>
      <div class="screenshot">
       <div class="mediaobject">
        <img src="images/default_appfinder.png" alt="Xfce4 Appfinder window is splitted in two parts: on the left we have
          categories and on the right found applications matching the category chosen.
        It also include a box to search applications matching a particular keyword."/>
       </div>
      </div>
     </div>
     <p>
    Double clicking an application will launch it, while a right click will
    show up a pop up menu, where getting informations about the selected item.</p>
    <div class="figure">
     <a name="handle-popup-fig"></a>
     <p class="title">
      <b>Figure 2. Popup menu</b>
     </p>
     <div class="screenshot">
      <div class="mediaobject">
       <img src="images/appfinder-handle-popup.png" alt="Right click popup menu."/>
      </div>
     </div>
    </div>
    <p>
   The informations window is useful to get all details of a desktop file entry.
   We can get informations about Name, Comment, Categories and Command.
    </p>
    <div class="figure">
     <a name="item-popup-fig"></a>
     <p class="title">
      <b>Figure 3. Item informations window</b>
     </p>
     <div class="screenshot">
      <div class="mediaobject">
       <img src="images/appfinder-item-popup.png" alt="Item informations window."/>
      </div>
     </div>
    </div>
   </div>
   <p>
   </p>
   <div class="sect1" lang="en">
    <div class="titlepage">
     <div>
      <div>
       <h2 class="title" style="clear: both">
        <a name="appfinder-advanced"></a>Appfinder Advanced features
       </h2>
      </div>
     </div>
    </div>
    <p>
     The Xfce 4 appfinder has the possibility to interact with other applications
     through drag and drop. At the actual state it can drop things on Xfce 4 menu editor
     and on some parts of Xfce 4 panel.
   </p>
    <p>
     You can edit desktop menu through Xfce 4 menu editor using drag and drop from Xfce 4 Appfinder.
     Searching applications and adding it to desktop menu will be easier to do and faster.
       You have only to select an item from the appfinder list and drag it on the menu editor list and
     enjoy the result.
   </p>
   <p>
     Xfce 4 appfinder also support drag and drop on Xfce 4 panel launcher settings window.
      You can drop appfinder items on the Command text entry of Xfce 4 panel launcher settings and get
     the full command written. A fast way to add a new application.
   </p>
   </div>
   <p>
   </p>
   <div class="sect1" lang="en">
    <div class="titlepage">
     <div>
      <div>
       <h2 class="title" style="clear: both">
        <a name="appfinder-copyright">
        </a>About <strong class="application">
        <code>xfce4-appfinder</code></strong>
       </h2>
      </div>
     </div>
    </div>
    <p>
     <strong class="application">
      <code>xfce4-appfinder</code>
     </strong> was written by Eduard Roccatello 
     (<code class="email">&lt;<a href="mailto:eduard@xfce.org">eduard@xfce.org</a>&gt;</code>). To find more information, please visit 
     the <a href="http://www.xfce.org">Xfce web site</a>.
    </p>
    <p>To report a bug or make a suggestion regarding this application or
     this manual, use the bug tracking system at <a href="http://bugzilla.xfce.org/">http://bugzilla.xfce.org/</a>.
   </p>
   <p>If you have questions about the use or installation of this package,
     please ask on the <a href="http://lunar-linux.org/mailman/listinfo/xfce">xfce</a> mailing list. Development discussion takes
     place on the <a href="http://lunar-linux.org/mailman/listinfo/xfce4-dev">xfce4-dev</a> mailing list.
   </p>
    <p>
     <strong class="application">
      <code>xfce4-appfinder</code>
     </strong> is distributed under the terms of the
     GNU General Public License as published by the Free Software Foundation; 
     either version 2 of the License, or (at your option) any later version.
  </p>
  <p>
 You should have received a copy of the GNU General Public License 
    along with this program; if not, write to the Free Software 
    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, 
    USA.
  </p>
   </div>
  </div>
 </body>
</html>
Comment 1 Nick Schermer editbugs 2011-06-06 23:05:32 CEST
Been merged in a mallard doc or removed.

Bug #4208

Reported by:
Matthias Krüger
Reported on: 2008-07-08
Last modified on: 2011-06-06

People

Assignee:
Jannis Pohlmann
CC List:
1 user

Version

Attachments

Additional information