Purpose of "fdpsh", the Fedora Documentation Project Shell

[Tommy Reynolds]

Hi, Folks!

Instead of adding process flow targets to
"docs-common/Makefile.common", or making very many interrelated
targets, let me offer an alternative: "fdp-functions" and "fdpsh".

My preferred technique to adding interrelated process steps is to
use lots of tiny shell scripts.  Shell scripts read like code to me
and the flow seems easier to understand.  To that end, I leveraged
Paul's "fdp-functions" beginnings by adding the "fdpsh" script.

The "fdpsh" script transforms your shell (unless you are running csh,
and if so, why are you ;-?) into an FDP-specific tool.  It takes care
of setting the necessary environment variables and provides handy
task-specific actions that could be awkward otherwise.  The ${PATH}
is also updated so that "docs-common/bin" is first on the searchlist.

So please consider adding shell functions for actions first, and
resorting to "Makefile.common" only if you must.  A target like:

show_workers:
 ${FDPBIN}/fdpsh -c get_all_workers

is a lot cleaner than exposing the individual steps in the
"Makefile".

End of commercial.  Thank you for your patience.  Please pay on your
way out.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://lists.fedoraproject.org/pipermail/docs/attachments/20060116/46b7408e/attachment.bin