Issue installing doc tools on OSX

Started by David Steelealmost 11 years ago7 messages

david@pgmasters.net

almost 11 years ago

1 attachment(s)

I had a problem installing the doc tools following the directions for
OSX at http://www.postgresql.org/docs/9.4/static/docguide-toolsets.html.
I'm running OSX Yosemite.

I got it to work by changing the command from:

sudo port install docbook-dsssl docbook-sgml-4.2 docbook-xml-4.2
docbook-xsl libxslt openjade opensp

To:

sudo port install docbook-dsssl docbook-sgml-4.2 docbook-xml-4.2
docbook-xsl libxslt opensp openjade

I didn't capture the error message unfortunately, but it was more or
less: unresolved dependency opensp while installing openjade.

Patch is attached.

--
- David Steele
david@pgmasters.net

Attachments:

doc-osx.patchtext/plain; charset=UTF-8; name=doc-osx.patch; x-mac-creator=0; x-mac-type=0Download

diff --git a/doc/src/sgml/docguide.sgml b/doc/src/sgml/docguide.sgml
index e0ae262..fa13404 100644
--- a/doc/src/sgml/docguide.sgml
+++ b/doc/src/sgml/docguide.sgml
@@ -280,7 +280,7 @@ apt-get install docbook docbook-dsssl docbook-xsl libxml2-utils openjade1.3 open
    <para>
     If you use MacPorts, the following will get you set up:
 <programlisting>
-sudo port install docbook-dsssl docbook-sgml-4.2 docbook-xml-4.2 docbook-xsl libxslt openjade opensp
+sudo port install docbook-dsssl docbook-sgml-4.2 docbook-xml-4.2 docbook-xsl libxslt opensp openjade
 </programlisting>
    </para>
   </sect2>

Peter Eisentraut

peter_e@gmx.net

almost 11 years ago

In reply to: David Steele (#1)

Re: Issue installing doc tools on OSX

On 2/15/15 6:31 PM, David Steele wrote:

I had a problem installing the doc tools following the directions for
OSX at http://www.postgresql.org/docs/9.4/static/docguide-toolsets.html.
I'm running OSX Yosemite.

I got it to work by changing the command from:

sudo port install docbook-dsssl docbook-sgml-4.2 docbook-xml-4.2
docbook-xsl libxslt openjade opensp

To:

sudo port install docbook-dsssl docbook-sgml-4.2 docbook-xml-4.2
docbook-xsl libxslt opensp openjade

I didn't capture the error message unfortunately, but it was more or
less: unresolved dependency opensp while installing openjade.

That seems a bit incredible, since port should be able to resolve the
dependencies by itself. I suggest that this should be reported as a bug
to MacPorts.

Also note that the other listed packages are also not ordered in
dependency order.

--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers

David Steele

david@pgmasters.net

almost 11 years ago

In reply to: Peter Eisentraut (#2)

Re: Issue installing doc tools on OSX

On 2/15/15 7:50 PM, Peter Eisentraut wrote:

On 2/15/15 6:31 PM, David Steele wrote:

I had a problem installing the doc tools following the directions for
OSX at http://www.postgresql.org/docs/9.4/static/docguide-toolsets.html.
I'm running OSX Yosemite.

I got it to work by changing the command from:

sudo port install docbook-dsssl docbook-sgml-4.2 docbook-xml-4.2
docbook-xsl libxslt openjade opensp

To:

sudo port install docbook-dsssl docbook-sgml-4.2 docbook-xml-4.2
docbook-xsl libxslt opensp openjade

I didn't capture the error message unfortunately, but it was more or
less: unresolved dependency opensp while installing openjade.

That seems a bit incredible, since port should be able to resolve the
dependencies by itself. I suggest that this should be reported as a bug
to MacPorts.

Sure, that has been my experience, but the error message was very clear.
Unfortunately I did not capture the error before I changed the order
and the log file was removed on the next run.

Since I have no easy way to reproduce it I'm not sure it's worth
submitting as a bug. However, I thought a reorder of the packages in
our docs couldn't hurt, and might help.

--
- David Steele
david@pgmasters.net

Peter Eisentraut

peter_e@gmx.net

almost 11 years ago

In reply to: David Steele (#3)

Re: Issue installing doc tools on OSX

On 2/15/15 9:23 PM, David Steele wrote:

That seems a bit incredible, since port should be able to resolve the
dependencies by itself. I suggest that this should be reported as a bug
to MacPorts.

Sure, that has been my experience, but the error message was very clear.
Unfortunately I did not capture the error before I changed the order
and the log file was removed on the next run.

How about uninstalling and reinstalling?

--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers

Florian Pflug

fgp@phlo.org

almost 11 years ago

In reply to: Peter Eisentraut (#4)

Re: Issue installing doc tools on OSX

On Feb16, 2015, at 23:18 , Peter Eisentraut <peter_e@gmx.net> wrote:

On 2/15/15 9:23 PM, David Steele wrote:

That seems a bit incredible, since port should be able to resolve the
dependencies by itself. I suggest that this should be reported as a bug
to MacPorts.

Sure, that has been my experience, but the error message was very clear.
Unfortunately I did not capture the error before I changed the order
and the log file was removed on the next run.

I just tried this on OS X 10.9.5 running MacPorts 2.3.3 and a ports tree
as of a few minutes ago. The command

After uninstalling docbook, opensp and openjade, re-installing them with

sudo port install docbook-dsssl docbook-sgml-4.2 docbook-xml-4.2 docbook-xsl
libxslt openjade opensp

completed without a hitch. It even logged

---> Computing dependencies for openjade
---> Dependencies to be installed: opensp

BTW, why does the list of suggested packages include docbook-xml? I was
under the impression that postgres used only the SGML version of docbook.
And I previously only has the SGML version installed, and I'm pretty sure
that I was able to build the documentation successfully.

best regards,
Florian Pflug

--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers

David Steele

david@pgmasters.net

almost 11 years ago

In reply to: Florian Pflug (#5)

Re: Issue installing doc tools on OSX

On 2/16/15 6:10 PM, Florian Pflug wrote:

On Feb16, 2015, at 23:18 , Peter Eisentraut <peter_e@gmx.net> wrote:

On 2/15/15 9:23 PM, David Steele wrote:

That seems a bit incredible, since port should be able to resolve the
dependencies by itself. I suggest that this should be reported as a bug
to MacPorts.

Sure, that has been my experience, but the error message was very clear.
Unfortunately I did not capture the error before I changed the order
and the log file was removed on the next run.

I just tried this on OS X 10.9.5 running MacPorts 2.3.3 and a ports tree
as of a few minutes ago. The command

After uninstalling docbook, opensp and openjade, re-installing them with

sudo port install docbook-dsssl docbook-sgml-4.2 docbook-xml-4.2 docbook-xsl
libxslt openjade opensp

completed without a hitch. It even logged

---> Computing dependencies for openjade
---> Dependencies to be installed: opensp

Yeah, it worked when I did the uninstall/reinstall.

--
- David Steele
david@pgmasters.net

Peter Eisentraut

peter_e@gmx.net

almost 11 years ago

In reply to: Florian Pflug (#5)

Re: Issue installing doc tools on OSX

On 2/16/15 6:10 PM, Florian Pflug wrote:

BTW, why does the list of suggested packages include docbook-xml?

That is used for building the man pages.

--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers