<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

<!--ArborText, Inc., 1988-1999, v.4002-->

<!ENTITY cmd "nautilus">

<!ENTITY % commonents SYSTEM "smancommon.ent">

%commonents;

<!ENTITY % booktitles SYSTEM "booktitles.ent">

%booktitles;

<!ENTITY suncopy "Copyright (c) 2003,2006,2007 Sun Microsystems, Inc. All Rights Reserved.">

]>

<?Pub UDT _bookmark _target>

<?Pub Inc>

<refentry id="nautilus-1">

<refmeta><refentrytitle>nautilus</refentrytitle><manvolnum>1</manvolnum>

<refmiscinfo class="date">08 Nov 2007</refmiscinfo>

<refmiscinfo class="sectdesc">&man1;</refmiscinfo>

<refmiscinfo class="software">&release;</refmiscinfo>

<refmiscinfo class="arch">generic</refmiscinfo>

<refmiscinfo class="copyright">&suncopy;</refmiscinfo>

</refmeta>

<indexterm><primary>nautilus</primary></indexterm><indexterm><primary>the

GNOME File Manager</primary></indexterm><refnamediv id="nautilus-1-name">

<refname>nautilus</refname><refpurpose>the GNOME File Manager</refpurpose></refnamediv>

<refsynopsisdiv id="nautilus-1-synp"><title>&synp-tt;</title>

<cmdsynopsis><command>&cmd;</command>

<arg choice="opt"><option>-browser</option></arg>

<arg choice="opt"><option>-check</option></arg>

<arg choice="opt"><option>-load-session=<replaceable>file</replaceable></option></arg>

<arg choice="opt"><option>-no-default-window</option></arg>

<arg choice="opt"><option>-no-desktop</option></arg>

<arg choice="opt"><option>-quit</option></arg>

<arg choice="opt"><option role="nodash"><replaceable>location</replaceable></option></arg>

<arg choice="opt"><option role="nodash"><replaceable>gnome-std-options</replaceable></option></arg>

</cmdsynopsis></refsynopsisdiv>

<refsect1 id="nautilus-1-desc"><title>&desc-tt;</title>

<para>The GNOME File Manager is the primary graphical interface to the file

system. It provides access to, and manipulation of, files and folders on both

local and remote filesystems by giving a virtual view of them. The File Manager

supports multiple view types to allow you to view files and folders as an

arrangement of icons, as a detailed list, or as a number of data-specific

views which allow embedded viewing of text, images and other multi-media.

</para>

<para>Nautilus provides the desktop backdrop and its associated icons for

launching applications, access to folders, the trash and removeable media

(such as CD-ROMs and zip disks). The trash container is a special view of

objects that have been removed from their original locations but not yet permanently

deleted from the system. Emptying the trash will delete these objects permanently.

</para>

<para>The side pane of the main window provides additional information about

the folder in the current view as well as allowing the user to add any arbitrary

notes; for example, to describe the folder or its contents. A tree view of

the filesystem is also available on the side bar, which can be used to switch

between the location of the main view and a history view to show the recently

viewed locations.</para>

</refsect1>

<refsect1 id="nautilus-1-opts"><title>&opts-tt;</title>

<para>The following options are supported:</para>

<variablelist termlength="wide">

<varlistentry><term><option>-browser</option></term><listitem>

<para>Open a browser window.</para>

</listitem></varlistentry>

<varlistentry><term><option>c</option>, <option>-check</option></term>

<listitem><para>

Perform a quick set of self-check tests.</para>

</listitem></varlistentry>

<varlistentry>

<term><option>l</option>, <option>-load-session=<replaceable>file</replaceable></option></term>

<listitem><para>

Load a saved session from the specified <replaceable>file</replaceable>.

Implies <option>-no-default-window</option>.</para>

</listitem></varlistentry>

<varlistentry>

<term><option>n</option>, <option>-no-default-window</option></term>

<listitem><para>

Only create windows for explicitly specified locations.</para>

</listitem></varlistentry>

<varlistentry>

<term><option>-no-desktop</option></term>

<listitem><para>

Do not manage the desktop backdrop.</para>

</listitem></varlistentry>

<varlistentry>

<term><option>q</option>, <option>-quit</option></term>

<listitem><para>

Quit a currently running Nautilus application.</para>

</listitem></varlistentry>

<varlistentry>

<term><option role="nodash"><replaceable>gnome-std-options</replaceable></option></term>

<listitem><para>

Standard options available for use with most GNOME applications. See

<citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry>

for more information.</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="nautilus-1-oper"><title>&oper-tt;</title>

<para>The following operands are supported:</para>

<variablelist termlength="narrow"><varlistentry><term><option role="nodash"><replaceable>

location</replaceable></option></term><listitem><para>The location to be viewed.

This location may be specified as a filesystem directory (for example, <literal>

/home/guest/Documents</literal>), or by using any of the URI schemes supported

by Nautilus (for example, <literal>http://www.sun.com</literal> or <literal>

ftp://ftp.gnome.org</literal>).</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="nautilus-1-exam"><title>&exam-tt;</title>

<example role="example"><title>Launching Nautilus to view a specific location

</title>

<para><screen>example% <userinput>&cmd; /home/guest/Images</userinput></screen></para>

</example>

<example role="example"><title>Opening a Nautilus window with

a specified width and height and without managing the desktop background</title>

<para><screen>example% <userinput>&cmd; --geometry=450x300 --no-desktop</userinput></screen></para>

</example>

</refsect1>

<refsect1 id="nautilus-1-exit"><title>&exit-tt;</title>

<para>The following exit values are returned:</para>

<variablelist termlength="xtranarrow"><varlistentry><term><returnvalue>0</returnvalue></term>

<listitem><para>Application exited successfully</para>

</listitem></varlistentry>

<varlistentry><term><returnvalue>>0</returnvalue></term><listitem><para>Application

exited with failure</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="nautilus-1-file"><title>&file-tt;</title>

<para>The following files are used by this application:</para>

<variablelist termlength="medium"><varlistentry><term><filename>/usr/bin/&cmd;</filename>

</term><listitem><para>The command-line executable for the GNOME file manager.

</para>

</listitem></varlistentry>

<varlistentry><term><filename>~/.&cmd;/*</filename> </term><listitem><para>

The location of user-specific meta-data, including notes, emblems, and background

patterns.</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="nautilus-1-attr"><title>&attr-tt;</title>

<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>

<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>

for descriptions of the following attributes:</para>

<informaltable frame="all">

<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">

<colspec colname="COLSPEC1" colwidth="1*">

<thead>

<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"

valign="middle">ATTRIBUTE VALUE</entry></row>

</thead>

<tbody>

<row><entry><para>Availability</para></entry><entry><para>gnome/file-manager/nautilus

</para></entry></row>

<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry

colname="COLSPEC1"><para>Volatile</para></entry></row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 id="nautilus-1-also"><title>&also-tt;</title>

<para>Latest version of the <citetitle>GNOME Desktop User Guide</citetitle> for your platform.</para>

<para>

<citerefentry><refentrytitle>nautilus-cd-burner</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>nautilus-file-management-properties</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>totem-video-thumbnailer</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>libgnomevfs-2</refentrytitle><manvolnum>3</manvolnum></citerefentry>,

<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,

<citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry>

</para>

</refsect1>

<refsect1 id="nautilus-1-note"><title>&note-tt;</title>

<para>Written by Stephen Browne, Sun Microsystems Inc., 2003, 2006, 2007.</para>

</refsect1>

</refentry>