Learn how easy it is to sync an existing GitHub or Google Code repo to a SourceForge project! See Demo

Close

#297 Documentation for libfm.conf and pcmanfm.conf

closed-rejected
nobody
None
5
2013-08-28
2013-08-25
Sworddragon
No

These configuration files contain options which are not completely self-explanatory to me. Also I can't find any documenation for them. It would be good if these options would be documented somewhere.

Discussion

  • Those files should be never changed by user because any changes in them will always be ignored by running application and files are rewritten on application exit. Options are meaningful only for developers and developers documentation (HTML) has full explanation of each option. Users should use Preferences dialog instead.
    In 1.2.0 version both those files will have the notice about that in them.
    Well, while libfm is in development, some options aren't available in Preferences dialog but they will be in pcmanfm 1.2.0 final release.
    Thanks.

     
    • status: open --> closed-rejected
     
  • Sworddragon
    Sworddragon
    2013-08-26

    I can't find this documentation here or in the source package. Can you give me a link to it?

     
  • Sworddragon
    Sworddragon
    2013-08-26

    • status: closed-rejected --> open-rejected
     
    • status: open-rejected --> closed-rejected
     
  • If you are using stable version in Ubuntu 13.10 then those options should be not required because all of them are covered by Preferences window. In any case you can find that documentation in the package libfm-dev.

     
  • Sworddragon
    Sworddragon
    2013-08-27

    This is what I get from te documentation:

    sworddragon@ubuntu:~/tmp$ ack-grep advanced_mode
    usr/share/gtk-doc/html/libfm/FmConfig.html
    212: gboolean advanced_mode;
    278:<td><p><span class="term"><span class="type">gboolean</span> <em class="structfield"><code><a name="FmConfig-struct.advanced-mode"></a>advanced_mode</code></em>;</span></p></td>

    usr/include/libfm-1.0/fm-config.h
    77: * @advanced_mode: enable advanced features for experienced user
    104: gboolean advanced_mode;
    sworddragon@ubuntu:~/tmp$ cat usr/share/gtk-doc/html/libfm/FmConfig.html | grep -C 3 FmConfig-struct.advanced-mode
    <td>desktop_id of the archiver used</td>
    </tr>
    <tr>
    <td><p><span class="term"><span class="type">gboolean</span> <em class="structfield"><code><a name="FmConfig-struct.advanced-mode"></a>advanced_mode</code></em>;</span></p></td>
    <td>enable advanced features for experienced user</td>
    </tr>
    </tbody>
    sworddragon@ubuntu:~/tmp$ ack-grep force_startup_notify
    usr/include/libfm-1.0/fm-config.h
    109: gboolean force_startup_notify; /* use startup notify by default */
    sworddragon@ubuntu:~/tmp$ ack-grep backup_as_hidden
    usr/include/libfm-1.0/fm-config.h
    113: gboolean backup_as_hidden; /* treat backup files as hidden */
    sworddragon@ubuntu:~/tmp$ ack-grep no_usb_trash
    usr/include/libfm-1.0/fm-config.h
    117: gboolean no_usb_trash; /* don't create trash folder on removable media */
    sworddragon@ubuntu:~/tmp$ ack-grep no_child_non_expandable
    usr/include/libfm-1.0/fm-config.h
    121: gboolean no_child_non_expandable; /* hide expanders on empty folder */
    sworddragon@ubuntu:~/tmp$ ack-grep show_internal_volumes
    usr/share/gtk-doc/html/libfm/FmConfig.html
    206: gboolean show_internal_volumes;
    262:<td><p><span class="term"><span class="type">gboolean</span> <em class="structfield"><code><a name="FmConfig-struct.show-internal-volumes"></a>show_internal_volumes</code></em>;</span></p></td>

    usr/include/libfm-1.0/fm-config.h
    73: * @show_internal_volumes: show system internal volumes in side pane. (udisks-only)
    98: gboolean show_internal_volumes;
    sworddragon@ubuntu:~/tmp$ cat usr/share/gtk-doc/html/libfm/FmConfig.html | grep -C 3 FmConfig-struct.show-internal-volumes
    <td>show thumbnails for files smaller than 'thumb_max' KB</td>
    </tr>
    <tr>
    <td><p><span class="term"><span class="type">gboolean</span> <em class="structfield"><code><a name="FmConfig-struct.show-internal-volumes"></a>show_internal_volumes</code></em>;</span></p></td>
    <td>show system internal volumes in side pane. (udisks-only)</td>
    </tr>
    <tr>

    Some entries need a better description. I'm still wondering what these advanced options are, what this startup notify is (as I never saw one) and what backup files are.

     
  • Sworddragon
    Sworddragon
    2013-08-27

    • status: closed-rejected --> open-rejected
     
    • status: open-rejected --> closed-rejected
     
  • Well, advanced mode currently affects only additional bits which may confuse users: SUID, SGID, sticky. It not intended to be in Preferences, if user is advanced he/she knows how to enable it. ;)
    Startup notification is "busy" animation when application starts - it is usually some rotation animation beside of cursor, it starts when you click on application and ends when application window appears. Unfortunately, it is broken in Openbox in Ubuntu and isn't shown, see https://bugs.launchpad.net/unity/+bug/862662
    The backup files are special files that end with tilda (~), they are sometimes created for information safety.

     
  • Sworddragon
    Sworddragon
    2013-08-28

    Thanks for the explanation :)
    The linked Launchpad ticket from you contains already Openbox as affected application so it is not needed to create another ticket (or did you mean something else?).

     
  • Sworddragon
    Sworddragon
    2013-08-28

    • status: closed-rejected --> open-rejected
     
  • Sworddragon
    Sworddragon
    2013-08-28

    • status: open-rejected --> closed-rejected