[kde-doc-english] patch to Konqueror Handbook

Wed Mar 8 08:42:25 CET 2006

I have made some very minor changes to the Konqueror Handbook in the
filemanager.docbook chapter (patchfile attached). Mostly, I worked on
the "View Modes" text by reordering the list to correspond to the way
it actually appears in Konqy as well as did some verbal cleanup (at
least to my liking, anyway). I also added text for Photobook and File
Size View, but conspicuously missing are File Replace View and CVS
Frontend. I figured that for a first pass, (this being my first ever
contribution), I could worry about those later.

I'm aware that the 3.5.2 docs are in string freeze, but I'm
assuming that, if there ever is a 3.5.3+ then string changes could be
considered, and anyway, I wanted to submit this to the list for
feedback. Thanks for any and all comments. :)

-jeff
-------------- next part --------------
8,9c8,9
< <date>2005-04-01</date>
< <releaseinfo>3.4</releaseinfo>
---
> <date>2006-03-08</date>
> <releaseinfo>3.5</releaseinfo>
17,22c17,21
< inverted tree structure descending and branching down from from a single top 
< level folder. This means that you can get from any folder to
< any other by going <quote>up</quote> until you reach a common point then
< <quote>down</quote> through the appropriate subfolders until you reach
< your
< target. </para>  
---
> hierarchy. Starting from a top level folder (also called the root directory), 
> the structure descends and branches containing various files and subfolders. 
> This means that you can get from any folder to any other by going <quote>up
> </quote> until you reach a common point then <quote>down</quote> through 
> the appropriate subfolders until you reach your target.</para>
24,32c23,31
< <para>The position of any file or folder in the tree can be described by its
< <quote>path</quote>, which is a simple list of the folders you would have
< to descend through to get to the target folder or file. For example 
< <filename class="directory">/home/pam</filename> is the subfolder <filename 
< class="directory">pam</filename> of the subfolder <filename
< class="directory">home</filename> of the top level folder, and <filename>
< /home/pam/words.txt</filename> is the file <filename>words.txt</filename> in 
< that subfolder. The leading <quote>/</quote> in these paths represents the 
< top level folder.</para>
---
> <para>The position of any file or folder in the structure (also called a 
> directory tree) can be described by its <quote>path</quote>, which is a simple 
> list of the folders you would have to descend through to get to the target 
> folder or file. For example <filename class="directory">/home/pam</filename> 
> is the subfolder <filename class="directory">pam</filename> of the subfolder 
> <filename class="directory">home</filename> of the top level folder, and 
> <filename>/home/pam/words.txt</filename> is the file <filename>words.txt
> </filename> in that subfolder. The leading <quote>/</quote> in these paths 
> represents the top level folder.</para>
36,39c35,37
< in the tree descending
< from /, their exact paths will depend on how your system was set up (see
< also
< the section on <link linkend="floppy-cd">Floppy and &CD-ROM; Drives</link>).
---
> in the tree descending from /, their exact paths will depend on how your system
> was set up (see also the section on <link linkend="floppy-cd">Floppy and
> &CD-ROM; Drives</link>).
54,65c52,59
< <para>In File Manager mode, &konqueror; shows you what files and 
< subfolders are held in a folder, and can provide you with some 
< information about them.</para>
< <para>The <quote>path</quote> of the folder you are looking at is shown in 
< the Titlebar, and also in the Location Toolbar, prefixed with <quote>file:
< </quote> to indicate that the folder is part of your computer's normal file 
< system. For example <filename>file:/home/pam</filename>.</para>
< 
< <para>The way that &konqueror; displays the files and folders depends mainly
< on your choice of View Mode. This can be selected from the <menuchoice>
< <guimenu>View</guimenu><guisubmenu>View Mode</guisubmenu></menuchoice> 
< sub menu, which gives you the following options:
---
> <para>In File Manager mode, &konqueror; lists which files and subfolders are
> contained within a given folder and can provide you with some information about
> them. The <quote>path</quote> of the current folder is shown in the Location
> Toolbar. The way that &konqueror; displays the files and folders depends mainly
> on your choice of view mode which can be selected from the
> <menuchoice><guimenu>View</guimenu><guisubmenu>View
> Mode</guisubmenu></menuchoice > sub menu. The view modes &konqueror; provides
> are outlined below.
72,73c66,73
< <listitem><para>Displays the name and a suitable icon for each file or folder.
< </para></listitem>
---
> <listitem><para>Displays an icon and a name for each file or subfolder in
> the current folder.</para>
> <para>Files of certain types may display a preview of their contents instead of
> the default icon. The file types selected for preview are controlled by the
> <menuchoice><guimenu>View</guimenu><guisubmenu>Preview</guisubmenu></menuchoice>
> sub menu settings. See the section <link linkend="previews">
> File Previews</link> of this handbook for more details.</para>
> </listitem>
78,79c78,81
< <listitem><para>Similar to <guimenuitem>Icon View</guimenuitem> except that the 
< display is neatly formatted into regular columns.</para>
---
> <listitem><para>Is similar to <guimenuitem>Icon View</guimenuitem> except that
> the current folder contents are organized into columns instead of rows.
> Files may be previewed in <guimenuitem>MultiColumn View</guimenuitem> as
> they are in <guimenuitem>Icon View</guimenuitem>.</para>
83a86,115
> <term><guimenuitem>Tree View</guimenuitem></term>
> <listitem><para>Can be used to <link linkend="navigation">navigate</link> the
> folder tree starting at the current folder. Each file and subfolder is
> shown on its own line. Folders can be expanded to reveal their contents by
> <mousebutton>left</mousebutton> clicking on the preceding <keycap>+</keycap>
> sign. Similarly, an expanded folder's contents can be hidden by
> <mousebutton>left</mousebutton> clicking on the <keycap>-</keycap> sign.</para>
> <para>In addition to the file name, some file detail information is shown on
> each line. The details are controlled by the <menuchoice>
> <guimenu>View</guimenu><guisubmenu>Show Details</guisubmenu></menuchoice>
> sub menu settings.</para>
> </listitem>
> </varlistentry>
> 
> <varlistentry>
> <term><guimenuitem>Info List View</guimenuitem></term>
> <listitem><para>Displays each file on a separate line similar to the
> <guimenuitem>
> Detailed List View</guimenuitem> except that the detail information is 
> specific to the file type. This feature is controlled by the
> <menuchoice><guimenu>View</guimenu><guisubmenu>View As</guisubmenu></menuchoice>
> sub menu.</para>
> <para>For example: If the file type is <quote>Folder,</quote> then the contents
> information is shown. Viewing as <quote>JPEG Images</quote> shows the pixel
> dimensions and EXIF data if available, and viewing as <quote>Plain Text</quote>
> shows the lines, words, characters, and format.
> </para></listitem>
> </varlistentry>
> 
> <varlistentry>
85,86c117,118
< <listitem><para>Displays each file or folder on a separate line, as a small 
< icon followed by the file or folder name followed by information about the 
---
> <listitem><para>Displays each file or folder on a separate line, as an icon
> followed by the file or folder name followed by information about the 
95c127
< <listitem><para>Similar to <guimenuitem>Detailed List View</guimenuitem> 
---
> <listitem><para>Is similar to the <guimenuitem>Detailed List View</guimenuitem> 
102,110c134,138
< <term><guimenuitem>Tree View</guimenuitem></term>
< <listitem><para>This option is useful for <link linkend="navigation">
< navigating</link> through the folder tree below the current folder. 
< The display is similar to <guimenuitem>Detailed List View</guimenuitem> 
< except that the start of each line will show a small <keycap>+</keycap> sign 
< in a box if the item is a folder. 
< <mousebutton>Left</mousebutton> clicking on the box will expand the display to
< show the contents of that folder.</para>
< </listitem>
---
> <term><guimenuitem>Photobook</guimenuitem></term>
> <listitem><para>Transforms &konqueror; into a simple viewing
> application for the current folder. Most of the main window renders a selected
> image, and thumbnails of the image files in the current directory are previewed
> along the side.</para></listitem>
114,117c142,149
< <term><guimenuitem>Info List View</guimenuitem></term>
< <listitem><para>Similar to <guimenuitem>Detailed List View</guimenuitem> 
< except that, where applicable, it shows the number of lines, words and 
< characters and file format for each file.
---
> <term><guimenuitem>File Size View</guimenuitem></term>
> <listitem><para>Creates a visual representation of the folder tree that reflects
> the file sizes of the folder contents. The window area represents all of the
> disk space used by the contents of the current folder. Subfolders and their
> contents are represented as rectangular blocks. The area of each block is
> proportional to the size of its contents. Various modifications to this
> visualization are controlled via the sub menus of the
> <menuchoice><guimenu>View</guimenu></menuchoice> menu.
122,125d153
< <para>The default file icons shown in <guimenuitem>Icon View</guimenuitem> and 
< <guimenuitem>MultiColumn View</guimenuitem> modes can be replaced by small 
< preview images of the file contents, see the section <link linkend="previews">
< File Previews</link> of this handbook for more details.</para>
131,134c159,160
< small pop up information 
< window to appear when the mouse pointer is hovered over a file or folder name 
< or icon in <guimenuitem>Icon View</guimenuitem> or <guimenuitem>
< MultiColumn View</guimenuitem> mode. 
---
> small pop up information window to appear when the mouse pointer is hovered over
> a file or folder name or icon. 
156,159c182,184
< </guilabel> page of the File Manager Configuration 
< dialog allows you to disable file previews for protocols such as 
< <link linkend="ftp">ftp</link> where reading the extra data would take too 
< long.</para>
---
> </guilabel> page of the File Manager Configuration dialog allows you to disable
> file previews for protocols such as <link linkend="ftp">ftp</link> where reading
> the extra data would take too long.</para>
170,171c195
< <para>To move between folders you can simply step up and down the
< tree:</para>
---
> <para>To move between folders you can simply step up and down the tree:</para>
174,176c198,200
< <listitem><para>To descend into a subfolder <mousebutton>left
< </mousebutton> click on its name or
< icon -- or if you have already <quote>selected</quote> it (see below) -- then just press
---
> <listitem><para>To descend into a subfolder <mousebutton>left</mousebutton>
> click on its name or icon &mdash; or if you have already <quote>selected</quote>
> it (see below) &mdash; then just press
179c203,204
< </guiicon> button in the Toolbar, use<keycombo action="simul">&Alt;<keysym>Up Arrow</keysym></keycombo>, or use the Menubar
---
> </guiicon> button in the Toolbar, use<keycombo action="simul">&Alt;<keysym>Up
> Arrow</keysym></keycombo>, or use the Menubar
217c242,243
< Arrow</keysym></keycombo>. Once you have gone back you can go forward. Use the Toolbar
---
> Arrow</keysym></keycombo>. Once you have gone back you can go forward. Use the
> Toolbar
224c250,252
< <para>Alternatively, you can also choose to enter the parent folder by clicking on the Toolbar <guiicon>Up</guiicon>, the <menuchoice><guimenu>Go</guimenu> <guimenuitem>Up</guimenuitem></menuchoice> item, or with <keycombo
---
> <para>Alternatively, you can also choose to enter the parent folder by clicking
> on the Toolbar <guiicon>Up</guiicon>, the <menuchoice><guimenu>Go</guimenu>
> <guimenuitem>Up</guimenuitem></menuchoice> item, or with <keycombo
261c289,290
< </filename>,  <filename class="directory">/media</filename>, <filename class="directory">/mnt</filename> or 
---
> </filename>,  <filename class="directory">/media</filename>, <filename
> class="directory">/mnt</filename> or 
386c415,417
< shortcut key combination. You can also select <link linkend="multiple">multiple</link> files or folders to copy/move as well.</para></listitem>
---
> shortcut key combination. You can also select <link
> linkend="multiple">multiple</link> files or folders to copy/move as
> well.</para></listitem>
488c519,520
< contains a file with the same name, &konqueror; will pop up a dialog box warning 
---
> contains a file with the same name, &konqueror; will pop up a dialog box
> warning 
552c584,587
< <para>You can also select multiple files and folders by holding the <keycap>&Ctrl;</keycap> button while you click on each individual file or folder. This enables you to then move or copy multiple files and folders to a different location at one time by using the same method above.</para>
---
> <para>You can also select multiple files and folders by holding the
> <keycap>&Ctrl;</keycap> button while you click on each individual file or
> folder. This enables you to then move or copy multiple files and folders to a
> different location at one time by using the same method above.</para>
629c664,665
< <term><menuchoice><guisubmenu>File</guisubmenu><guimenuitem>Link To Application...</guimenuitem>
---
> <term><menuchoice><guisubmenu>File</guisubmenu><guimenuitem>Link To
> Application...</guimenuitem>
636c672,673
< icon. In the <guilabel>Application</guilabel> page you must enter the <guilabel>Command</guilabel> that
---
> icon. In the <guilabel>Application</guilabel> page you must enter the
> <guilabel>Command</guilabel> that
667c704,705
< <term><menuchoice><guisubmenu>File</guisubmenu><guimenuitem>Link To Location (URL)...</guimenuitem></menuchoice></term>
---
> <term><menuchoice><guisubmenu>File</guisubmenu><guimenuitem>Link To Location
> (URL)...</guimenuitem></menuchoice></term>
685c723,724
< <term><menuchoice><guisubmenu>Device</guisubmenu><guimenuitem>Floppy Device...</guimenuitem></menuchoice></term>
---
> <term><menuchoice><guisubmenu>Device</guisubmenu><guimenuitem>Floppy
> Device...</guimenuitem></menuchoice></term>
691c730,731
< that is not normally mounted.  However, in most cases you will want to create the icon
---
> that is not normally mounted.  However, in most cases you will want to create
> the icon
706c746,747
< Device...</guimenuitem> but for a <acronym>CD</acronym> or <acronym>DVD</acronym> 
---
> Device...</guimenuitem> but for a <acronym>CD</acronym> or
> <acronym>DVD</acronym> 
768c809,810
< <guimenuitem>Rename</guimenuitem>, or select the file or folder and then press the <keycap>F2</keycap> button.</para>
---
> <guimenuitem>Rename</guimenuitem>, or select the file or folder and then press
> the <keycap>F2</keycap> button.</para>
808c850,851
< administrator, often known as the Super User or <systemitem class="username">root</systemitem>. </para>
---
> administrator, often known as the Super User or <systemitem
> class="username">root</systemitem>. </para>
815c858,859
< </guimenuitem></menuchoice>. You will be asked for the <systemitem class="username">root</systemitem>
---
> </guimenuitem></menuchoice>. You will be asked for the <systemitem
> class="username">root</systemitem>
819c863,864
< <warning><para>Take care.  As Super User (<systemitem class="username">root</systemitem>), you have complete control of
---
> <warning><para>Take care.  As Super User (<systemitem
> class="username">root</systemitem>), you have complete control of
821c866,867
< <para>Also, connecting to the internet as <systemitem class="username">root</systemitem> is an extremely bad idea, as it
---
> <para>Also, connecting to the internet as <systemitem
> class="username">root</systemitem> is an extremely bad idea, as it