Purpose of "fdpsh", the Fedora Documentation Project Shell

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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.

Attachment: pgpZpm7HHRy0G.pgp
Description: PGP signature

-- 

fedora-docs-list@xxxxxxxxxx
To unsubscribe: 
https://www.redhat.com/mailman/listinfo/fedora-docs-list

[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux