@@ -1,21 +1,22 @@ Ordered by date of first contribution: - Christian Vest Hansen - Rob Cowie - Jeff Forcier - Travis Cline - Niklas Lindström - Kevin Horn - Max Battcher - Alexander Artemenko - Dennis Schoen - Erick Dennis - Sverre Johansen - Michael Stephens - Armin Ronacher - Curt Micol - Patrick McNerthney - Steve Steiner - Ali Saifee - Jorge Vargas + +Christian Vest Hansen +Rob Cowie +Jeff Forcier +Travis Cline +Niklas Lindström +Kevin Horn +Max Battcher +Alexander Artemenko +Dennis Schoen +Erick Dennis +Sverre Johansen +Michael Stephens +Armin Ronacher +Curt Micol +Patrick McNerthney +Steve Steiner +Ali Saifee +Jorge Vargas Peter Ellis Brian Rosner AUTHORS @@ -1,10 +1,14 @@ +================================= +Fabric Frequently Asked Questions +================================= + This is a dev-oriented list of FAQs from users. Once we get to maybe 10 or more, turn this into an actual document. (Would rather not have a user facing FAQ doc with only one or two entries, and too lazy to brainstorm a bunch of anticipated FAQs right now...) 1. Why do I sometimes see ``err: stdin: is not a tty``? -------------------------------------------------------- +======================================================= This message is typically generated by programs such as ``biff`` or ``mesg`` lurking within your remote user's ``.profile`` or ``.bashrc`` files (or any @@ -31,7 +35,7 @@ There are multiple ways to deal with this problem: 2. Why can't I run programs in the background with ``&``? It makes Fabric hang. -------------------------------------------------------------------------------- +=============================================================================== Because Fabric executes a shell on the remote end for each invocation of ``run`` or ``sudo``, techniques like backgrounding (or using ``cd``, but see @@ -55,7 +59,7 @@ and thus your Fabric task will continue executing as intended. 3. My remote system doesn't have ``bash`` installed by default, do I need to install ``bash``? ----------------------------------------------------------------------------------------------- +============================================================================================== While Fabric is written with ``bash`` in mind, it's not an absolute requirement. Simply change ``env.shell`` to call your desired shell, and FAQ @@ -1 +1,2 @@ -For installation help, please see docs/installation.rst. +For installation help, please see http://fabfile.org/ or (if using a source +checkout) docs/installation.rst. INSTALL @@ -3,10 +3,10 @@ FAQ INSTALL LICENSE README -TODO docs fabfile.py fabric +paramiko requirements.txt setup.py tests MANIFEST @@ -31,3 +31,6 @@ In addition to use via the ``fab`` fool, Fabric's components may be imported into other Python code, providing a Pythonic interface to the SSH protocol suite at a higher level than that provided by e.g. Paramiko (which Fabric itself leverages.) + +For detailed information about Fabric's installation and use, please visit its +website, http://fabfile.org . README df112425b85bf79f01c8f14a75586688bcb58dc5 Jeff Forcier jeff@bitprophet.org http://github.com/bitprophet/fabric/commit/20e558f77844dd29ceacf2fb0e06f966e270222b 20e558f77844dd29ceacf2fb0e06f966e270222b

2009-10-25T20:07:40-07:00

More pre-release cleanup. 6109c0a90c686a7b69b520cdf74037edd509b051 Jeff Forcier jeff@bitprophet.org