Editing Documentation/Maemo 5 Developer Guide/Packaging, Deploying and Distributing/Installing under opt and MyDocs

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

The N900 has about 100MB of free space in the root file system partition. This is not very much and would fill up quite quickly when installing additional applications. As a workaround, the <code>/opt</code> directory has been linked to a different partition with more space (about 1 GB) and <code>/home/user/MyDocs</code> is also available in certain cases, with even more space (about 25 GB). Developers are encouraged to make good use of them, specially for applications requiring more than 500KB, including dependencies.

== /opt as a good alternative ==

The <code>/opt</code> directory is on an ext3 partition that is permanently mounted. Users cannot mess with it by accident. Of course, not everything needs to be moved to <code>/opt</code>: configuration files are best left in <code>/etc</code>, for example, and there is no point in moving small files like the various <code>*.desktop</code> and <code>*.service</code> files (except for the fact that automake configure --prefix moves them there whether you want to or not).

The maemo-optify tool helps developers to prepare Debian packages that use <code>/opt</code>. This tool moves selected files inside the package to locations under <code>/opt</code>, and will symbolically link from the original location to the new place of the file. It is available on [http://gitorious.org/maemo-af/maemo-optify gitorious] as well as in [http://maemo.org/packages/view/maemo-optify/ Extras-devel].

The [[Uploading_to_Extras-devel#Autobuilder_special_considerations|Autobuilder]] supports automatic optification of submitted packages via maemo-optify. It is triggered by the file "<code>debian/optify</code>", as described in the [http://gitorious.org/maemo-af/maemo-optify/blobs/master/README README].

== Considering /home/user/MyDocs ==

The <code>/home/user/MyDocs</code> directory is another candidate for large collections of data files included in applications such as game graphics or maps. Using <code>/opt</code> is mostly transparent to package maintainers and end-users, but <code>/home/user/MyDocs</code> needs more careful consideration.

The <code>/home/user/MyDocs</code> partition uses VFAT as its filesystem (which has some limitations compared to ext3) and it is removable: it will be unmounted and exported over USB when the user plugs in the cable. Also, <code>/home/user/MyDocs</code> is visible in the File manager. This all means:

* Be aware that VFAT is not really a POSIX filesystem. Things like symbolic links, permission bits, and so on, will not work as nicely as they do on a real POSIX filesystem.
* Be prepared that your files are not there at all while the partition is unmounted. Do not prevent the partition from being unmounted because you keep some of the files open.
* User might see your files, can get confused and try to delete or rename them.

In summary, you cannot really put programs, libraries or theme graphics into <code>/home/user/MyDocs</code>. Instead, use <code>/opt</code> for these.

[[Category:Development]]
[[Category:Documentation]]
[[Category:Fremantle]]

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Retrieved from "http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Packaging,_Deploying_and_Distributing/Installing_under_opt_and_MyDocs"

Personal tools

Navigation

Views

Editing Documentation/Maemo 5 Developer Guide/Packaging, Deploying and Distributing/Installing under opt and MyDocs

@@ Line 1: / Line 1: @@
-The N900 has about 100 MB of free space in the root file system partition. This is not very much and would fill up quite quickly when installing additional applications. As a workaround, the <code>/opt</code> directory has been linked to a different partition with more space (about 1 GB) and <code>/home/user/MyDocs</code> is also available in certain cases, with even more space (about 25 GB). Developers are encouraged to make good use of them, specially for applications requiring more than 500 KB, including dependencies.
+The N900 has about 100MB of free space in the root file system partition. This is not very much and would fill up quite quickly when installing additional applications. As a workaround, the <code>/opt</code> directory has been linked to a different partition with more space (about 1 GB) and <code>/home/user/MyDocs</code> is also available in certain cases, with even more space (about 25 GB). Developers are encouraged to make good use of them, specially for applications requiring more than 500KB, including dependencies.
 == /opt as a good alternative ==
-The <code>/opt</code> directory is on an ext3 partition that is permanently mounted. Users cannot mess with it by accident. Of course, not everything needs to be moved to <code>/opt</code>: configuration files are best left in <code>/etc</code>, for example, and there is no point in moving small files like the various <code>*.desktop</code> and <code>*.service</code> files (except for the fact that automake's "<code>configure --prefix=/opt</code>" moves them there whether you want to or not).
+The <code>/opt</code> directory is on an ext3 partition that is permanently mounted. Users cannot mess with it by accident. Of course, not everything needs to be moved to <code>/opt</code>: configuration files are best left in <code>/etc</code>, for example, and there is no point in moving small files like the various <code>*.desktop</code> and <code>*.service</code> files (except for the fact that automake configure --prefix moves them there whether you want to or not).
-The <code>maemo-optify</code> tool helps developers to prepare Debian packages that use <code>/opt</code>. This tool moves selected files inside the package to locations under <code>/opt</code>, and will symbolically link from the original location to the new place of the file. It is available on [http://gitorious.org/maemo-af/maemo-optify gitorious] as well as in [http://maemo.org/packages/view/maemo-optify/ Extras-devel].
+The maemo-optify tool helps developers to prepare Debian packages that use <code>/opt</code>. This tool moves selected files inside the package to locations under <code>/opt</code>, and will symbolically link from the original location to the new place of the file. It is available on [http://gitorious.org/maemo-af/maemo-optify gitorious] as well as in [http://maemo.org/packages/view/maemo-optify/ Extras-devel].
-The [[Uploading_to_Extras-devel#Autobuilder_special_considerations|Autobuilder]] supports automatic optification of submitted packages via <code>maemo-optify</code>. It is triggered by the file "<code>debian/optify</code>", as described in the [http://gitorious.org/maemo-af/maemo-optify/blobs/master/README README].
+The [[Uploading_to_Extras-devel#Autobuilder_special_considerations|Autobuilder]] supports automatic optification of submitted packages via maemo-optify. It is triggered by the file "<code>debian/optify</code>", as described in the [http://gitorious.org/maemo-af/maemo-optify/blobs/master/README README].
 == Considering /home/user/MyDocs ==
-The [[MyDocs_folder|<code>/home/user/MyDocs</code>]] directory is another candidate for large collections of data files included in applications such as game graphics or maps. Using <code>/opt</code> is mostly transparent to package maintainers and end-users, but <code>/home/user/MyDocs</code> needs more careful consideration.
+The <code>/home/user/MyDocs</code> directory is another candidate for large collections of data files included in applications such as game graphics or maps. Using <code>/opt</code> is mostly transparent to package maintainers and end-users, but <code>/home/user/MyDocs</code> needs more careful consideration.
 The <code>/home/user/MyDocs</code> partition uses VFAT as its filesystem (which has some limitations compared to ext3) and it is removable: it will be unmounted and exported over USB when the user plugs in the cable. Also, <code>/home/user/MyDocs</code> is visible in the File manager. This all means: