[multimedia/kid3] doc/en: Update documentation

Urs Fleisch null at kde.org
Sun Oct 17 11:49:48 BST 2021


Git commit 53c8fce3b5dd579a7059c4082fbc96f769ff9488 by Urs Fleisch.
Committed on 17/10/2021 at 10:49.
Pushed by ufleisch into branch 'master'.

Update documentation

M  +25   -1    doc/en/index.docbook

https://invent.kde.org/multimedia/kid3/commit/53c8fce3b5dd579a7059c4082fbc96f769ff9488

diff --git a/doc/en/index.docbook b/doc/en/index.docbook
index 47e961d3..66381602 100644
--- a/doc/en/index.docbook
+++ b/doc/en/index.docbook
@@ -389,6 +389,10 @@ the columns can be changed by drag and drop. The sort order can be toggled by
 clicking on the column header.
 </para>
 <para>
+The values of the standard tags can also be displayed and edited in columns of
+the file list.
+</para>
+<para>
 At the left of the names an icon can be displayed: a disc to show that the
 file has been modified or information about which tags are present (V1, V2,
 V1V2 or NO TAG, no icon is displayed if the file has not been read in yet).
@@ -875,6 +879,13 @@ order to add a frame with name "<literal>MEDIA</literal>" and not
 "<literal>SOURCEMEDIA</literal>", use "<literal>!MEDIA</literal>" to force the
 explicit name.
 </para></listitem>
+<listitem><para>
+If you need a frame which is not in this list, you still have the possibility
+to enter arbitrary names using the <guibutton>Add</guibutton> button. Often
+used frame names can be added to the <guilabel>Custom Frames</guilabel> in the
+<guilabel>Tags</guilabel> configuration, and will then be available in the
+<guilabel>Quick Access Frames</guilabel>.
+</para></listitem>
 </itemizedlist>
 </para>
 
@@ -2305,6 +2316,11 @@ If <guilabel>Show only custom genres</guilabel> is not active, the custom
 genres can be found at the end of the genres list.
 </para>
 <para>
+In <guilabel>Custom Frames</guilabel>, up to eight custom frame names can be
+defined, which can then be used like the unified frames, for example as
+quick access frames.
+</para>
+<para>
 <guilabel>Quick Access Frames</guilabel> defines which frame types are always
 shown in the <link linkend="tag2">Tag 2</link> section. Such frames can
 then be added without first using the <guibutton>Add</guibutton> button.
@@ -2429,6 +2445,13 @@ boxes (with arrows up and down), which can be found in the
 filenames. The same options as in <guilabel>Tag Format</guilabel> are available.
 </para>
 <para>
+Additionally, the <guilabel>Maximum length</guilabel> allowed for file names can
+be set. Most modern file systems have a limit of 255 characters, but if you want
+to burn the files to CD, you should set the limit to 64.
+If <guilabel>Use for playlist and folder names</guilabel> is checked, the
+file name format is also used when creating playlists and renaming folders.
+</para>
+<para>
 The <guilabel>User Actions</guilabel> page contains a table with the commands
 which are available in the context menu of the file list. For critical
 operations such as deleting files, it is advisable to mark
@@ -3450,7 +3473,8 @@ and build all required libraries and create a &kid3; package.
 <title>Configuration</title>
 
 <para>With &kde;, the settings are stored in
-<filename>.config/kid3rc</filename>.
+<filename>.config/kid3rc</filename>,
+the application state in <filename>.local/share/kid3/kid3staterc</filename>.
 As a &Qt; application, this file is
 in <filename>.config/Kid3/Kid3.conf</filename>. On &Windows;,
 the configuration is stored in the registry. on &macOS; in a plist file.


More information about the kde-doc-english mailing list