PHP docs install instructions lead to wrong SCA_SDO version being installed

[simonslaws-gM/Ye1E23mwN+]

I just tried the install instructions we have in the PHP Docs for the
SCA_SDO package.

pecl install sdo

This causes version 1.0.4 of the package to be installed. Can someone
who knows how, fix this, so that it reads

pecl install SCA_SDO

or tell me how to fix the docs and I'll do it.

Simon


--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa-/***@public.gmane.org
To unsubscribe from this group, send email to phpsoa-unsubscribe-/***@public.gmane.org
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[Matthew Peters]

Post by simonslaws-gM/Ye1E23mwN+
or tell me how to fix the docs and I'll do it.

Fixing the docs is a bit of a pig because it is a Linux-based XML-
based (DocBook) compile-style activity. I'll fix this one right now.
Sometime, if you fancy a go, here are some notes on the process:

PHP uses DocBook for extension documentation. Documentation is written
in XML and then 'make' is used to generate various document formats
(e.g. html, pdf, Windows Help, etc.).

Documentation is held in the php cvs repository. Check out the phpdoc
folder from the PHP CVS repository.

Note, this includes the howto and scripts mentioned in Dan's
presentation...

Advice from Dan Scott: The core information you need to know to get
started is here: http://doc.php.net/php/dochowto/index.php. The
overall PHP documentation project is described in this presentation:
http://coffeecode.net/uploads/talks/phptropics-docs.pdf

The following is the page in the howto doc that describes the
conventions to follow http://doc.php.net/php/dochowto/chapter-conventions.php.

WATCH OUT We should be validating the documentation before checking it
in. http://doc.php.net/php/dochowto/chapter-validating.php

This means make test and make test_xml before checking in.

Speed

If you have used the documentation tools on Windows/Cygwin you will
have learnt how slow they are. They go much faster on Linux even when
running in a VMWare machine. make html for the three SDO sections
takes about 1m 30s on a VMWare-hosted Linux instead of 5 minutes and
upwards on Windows, when running on the same physical machine.



--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa-/***@public.gmane.org
To unsubscribe from this group, send email to phpsoa-unsubscribe-/***@public.gmane.org
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[simonslaws-gM/Ye1E23mwN+]

Wow, thank you Matthew for the very comprehensive reply.

Simon


--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa-/***@public.gmane.org
To unsubscribe from this group, send email to phpsoa-unsubscribe-/***@public.gmane.org
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[Matthew Peters]

Post by simonslaws-gM/Ye1E23mwN+
or tell me how to fix the docs and I'll do it.

Fixing the docs is a bit of a pig because it is a Linux-based XML-
based (DocBook) compile-style activity. I'll fix this one right now.
Sometime, if you fancy a go, here are some notes on the process:

PHP uses DocBook for extension documentation. Documentation is written
in XML and then 'make' is used to generate various document formats
(e.g. html, pdf, Windows Help, etc.).

Documentation is held in the php cvs repository. Check out the phpdoc
folder from the PHP CVS repository.

Note, this includes the howto and scripts mentioned in Dan's
presentation...

Advice from Dan Scott: The core information you need to know to get
started is here: http://doc.php.net/php/dochowto/index.php. The
overall PHP documentation project is described in this presentation:
http://coffeecode.net/uploads/talks/phptropics-docs.pdf

The following is the page in the howto doc that describes the
conventions to follow http://doc.php.net/php/dochowto/chapter-conventions.php.

WATCH OUT We should be validating the documentation before checking it
in. http://doc.php.net/php/dochowto/chapter-validating.php

This means make test and make test_xml before checking in.

Speed

If you have used the documentation tools on Windows/Cygwin you will
have learnt how slow they are. They go much faster on Linux even when
running in a VMWare machine. make html for the three SDO sections
takes about 1m 30s on a VMWare-hosted Linux instead of 5 minutes and
upwards on Windows, when running on the same physical machine.



--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa-/***@public.gmane.org
To unsubscribe from this group, send email to phpsoa-unsubscribe-/***@public.gmane.org
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[Matthew Peters]

Post by simonslaws-gM/Ye1E23mwN+
or tell me how to fix the docs and I'll do it.

Fixing the docs is a bit of a pig because it is a Linux-based XML-
based (DocBook) compile-style activity. I'll fix this one right now.
Sometime, if you fancy a go, here are some notes on the process:

PHP uses DocBook for extension documentation. Documentation is written
in XML and then 'make' is used to generate various document formats
(e.g. html, pdf, Windows Help, etc.).

Documentation is held in the php cvs repository. Check out the phpdoc
folder from the PHP CVS repository.

Note, this includes the howto and scripts mentioned in Dan's
presentation...

Advice from Dan Scott: The core information you need to know to get
started is here: http://doc.php.net/php/dochowto/index.php. The
overall PHP documentation project is described in this presentation:
http://coffeecode.net/uploads/talks/phptropics-docs.pdf

The following is the page in the howto doc that describes the
conventions to follow http://doc.php.net/php/dochowto/chapter-conventions.php.

WATCH OUT We should be validating the documentation before checking it
in. http://doc.php.net/php/dochowto/chapter-validating.php

This means make test and make test_xml before checking in.

Speed

If you have used the documentation tools on Windows/Cygwin you will
have learnt how slow they are. They go much faster on Linux even when
running in a VMWare machine. make html for the three SDO sections
takes about 1m 30s on a VMWare-hosted Linux instead of 5 minutes and
upwards on Windows, when running on the same physical machine.



--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa-/***@public.gmane.org
To unsubscribe from this group, send email to phpsoa-unsubscribe-/***@public.gmane.org
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[Matthew Peters]

Post by simonslaws-gM/Ye1E23mwN+
or tell me how to fix the docs and I'll do it.

Fixing the docs takes a bit of investment because it is a Linux-based
XML-based (DocBook) compile-style activity. I'll fix this one right
now. Sometime, if you fancy a go, here are some notes on the process:

PHP uses DocBook for extension documentation. Documentation is written
in XML and then 'make' is used to generate various document formats
(e.g. html, pdf, Windows Help, etc.).

Documentation is held in the php cvs repository. Check out the phpdoc
folder from the PHP CVS repository.

Note, this includes the howto and scripts mentioned in Dan's
presentation...

Advice from Dan Scott: The core information you need to know to get
started is here: http://doc.php.net/php/dochowto/index.php. The
overall PHP documentation project is described in this presentation:
http://coffeecode.net/uploads/talks/phptropics-docs.pdf

The following is the page in the howto doc that describes the
conventions to follow http://doc.php.net/php/dochowto/chapter-conventions.php.

WATCH OUT We should be validating the documentation before checking it
in. http://doc.php.net/php/dochowto/chapter-validating.php

This means make test and make test_xml before checking in.

Speed

If you have used the documentation tools on Windows/Cygwin you will
have learnt how slow they are. They go much faster on Linux even when
running in a VMWare machine. make html for the three SDO sections
takes about 1m 30s on a VMWare-hosted Linux instead of 5 minutes and
upwards on Windows, when running on the same physical machine.



--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa-/***@public.gmane.org
To unsubscribe from this group, send email to phpsoa-unsubscribe-/***@public.gmane.org
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---

[Matthew Peters]

Post by simonslaws-gM/Ye1E23mwN+
or tell me how to fix the docs and I'll do it.

Fixing the docs takes a bit of investment because it is a Linux-based
XML-based (DocBook) compile-style activity. I'll fix this one right
now. Sometime, if you fancy a go, here are some notes on the process:

PHP uses DocBook for extension documentation. Documentation is written
in XML and then 'make' is used to generate various document formats
(e.g. html, pdf, Windows Help, etc.).

Documentation is held in the php cvs repository. Check out the phpdoc
folder from the PHP CVS repository.

Note, this includes the howto and scripts mentioned in Dan's
presentation...

Advice from Dan Scott: The core information you need to know to get
started is here: http://doc.php.net/php/dochowto/index.php. The
overall PHP documentation project is described in this presentation:
http://coffeecode.net/uploads/talks/phptropics-docs.pdf

The following is the page in the howto doc that describes the
conventions to follow http://doc.php.net/php/dochowto/chapter-conventions.php.

WATCH OUT We should be validating the documentation before checking it
in. http://doc.php.net/php/dochowto/chapter-validating.php

This means make test and make test_xml before checking in.

Speed

If you have used the documentation tools on Windows/Cygwin you will
have learnt how slow they are. They go much faster on Linux even when
running in a VMWare machine. make html for the three SDO sections
takes about 1m 30s on a VMWare-hosted Linux instead of 5 minutes and
upwards on Windows, when running on the same physical machine.



--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "phpsoa" group.
To post to this group, send email to phpsoa-/***@public.gmane.org
To unsubscribe from this group, send email to phpsoa-unsubscribe-/***@public.gmane.org
For more options, visit this group at http://groups.google.co.uk/group/phpsoa?hl=en
-~----------~----~----~----~------~----~------~--~---