[39807] trunk/doc-new/guide/xml/installing.xml

[Ryan Schmidt]

On Sep 5, 2008, at 4:06 PM, markd at macports.org wrote:

> Revision: 39807
>           http://trac.macports.org/changeset/39807
> Author:   markd at macports.org
> Date:     2008-09-05 14:06:16 -0700 (Fri, 05 Sep 2008)
> Log Message:
> -----------
> Fix the X11 section to work with 10.5.
>
> Modified Paths:
> --------------
>     trunk/doc-new/guide/xml/installing.xml
>
> Modified: trunk/doc-new/guide/xml/installing.xml
> ===================================================================
> --- trunk/doc-new/guide/xml/installing.xml	2008-09-05 19:53:59 UTC  
> (rev 39806)
> +++ trunk/doc-new/guide/xml/installing.xml	2008-09-05 21:06:16 UTC  
> (rev 39807)
> @@ -38,19 +38,18 @@
>        <listitem>
>          <para>Click <guibutton>Install</guibutton> to install  
> X11.</para>
>        </listitem>
> -
> -      <listitem>
> -        <para>Drag the <filename>/Applications/Utilities/X11</ 
> filename> icon
> -        to your dock —you must open X11 before launching an X11
> -        application.</para>
> -      </listitem>
>      </orderedlist>

The instruction to put X11 in the Dock never made much sense to me;  
an application does not need to be in the Dock for me to be able to  
open it.

However, the instruction to open X11 before trying to run an X11 app  
is very necessary on Tiger and earlier, and should do no harm on  
Leopard and later.

> -    <para>If you're using Mac OS X 10.3 then you can download the X11
> -    installer from the Apple <ulink
> -    url="http://apple.com/support/downloads/ 
> x11formacosx.html">download
> -    page</ulink>.</para>

I wish you would not remove information about how to install X11 on  
Panther.

> +    <para>Before launching an X11 application, you must open a  
> terminal window
> +    and start an xterm session.</para>

Really? Why? If X11 is open, it shouldn't matter if an xterm is open  
or not.

> +    <programlisting><prompt>%%</prompt> <userinput>xterm</ 
> userinput></programlisting>
> +
> +    <para>After the X11 session window opens, you may launch X11  
> apps from
> +    another terminal window. See <link
> +    linkend="installing.x11.settings">Optional X11 Settings</link>  
> if you wish
> +    to launch X11 applications from an X11 session window.</para>
> +
>      <note>
>        <para>X11 and the X11SDK (from Xcode Tools) are both  
> required for X11
>        apps. To verify the presence of both, check for files
> @@ -66,18 +65,8 @@
>        <title>Optional X11 Settings</title>
>
>        <para>To launch X11 applications directly from an X11 window  
> (instead of
> -      a terminal window), you need to have the MacPorts paths  
> imported into
> -      X11 sessions when they are opened. This is a two step  
> process.</para>
> -
> -      <para>First, tell X11 about the <filename>~/.profile</ 
> filename> file
> -      that will be created after you install MacPorts. Do this by  
> editing the
> -      file <filename>/etc/X11/xinit/xinitrc</filename> and adding  
> this line
> -      near the top.</para>
> -
> -      <programlisting>source ~/.profile</programlisting>
> -
> -      <para>Now finish the process by making subsequent X11  
> sessions opened
> -      using the menu bar respect your <filename>.profile</filename>
> +      a regular terminal window), you need to make it so X11  
> sessions opened
> +      using the menu bar respect your <filename>.~profile</filename>
>        file.</para>

So.... these new instructions are now correct, for all versions of  
Mac OS X?