bug#7515: [PATCH] Info Elisp::call-process -- Add process run directory information

[Jari Aalto]

tags 7515 + patch
thanks

2010-11-30 00:50 Glenn Morris <rgm@gnu.org>:
>> Please add documentation to info page Elisp::call-process
>>
>>     37.3 Creating a Synchronous Process
>>
>> What variable affects the location where process is being run:
>
> 37.1 Functions that Create Subprocesses
>
>   Synchronous and asynchronous processes are explained in the
> following sections. Since the three functions are all called in a
> similar fashion, their common arguments are described here.
>
> [...]
>
>    The subprocess gets its current directory from the value of
> `default-directory' (*note File Name Expansion::).

I propose that the information is also mentioned in 31.7::call-process
because at the same page, this is mentioned in context of another
command:

 -- Function: process-file program &optional infile buffer display
          &rest args
     This function processes files synchronously in a separate process.
     It is similar to `call-process' but may invoke a file handler based
     on the value of the variable `default-directory'.  The current
     working directory of the subprocess is `default-directory'. 

-----------------------------------------------------------------------
2010-11-30  Jari Aalto  <jari.aalto@cante.net>

        * processes.texi (Synchronous Processes): In `call-process'
        description, mention `default-directory'.

>From b98e980f7e31d1e2444321fa76ffc56a39db50f3 Mon Sep 17 00:00:00 2001
From: Jari Aalto <jari.aalto@cante.net>
Date: Tue, 30 Nov 2010 08:41:41 +0200
Subject: [PATCH] processes.texi (Synchronous Processes): In call-process, 
mention default-directory
Organization: Private
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 8bit


Signed-off-by: Jari Aalto <jari.aalto@cante.net>
---
 doc/lispref/processes.texi |    3 ++-
 1 files changed, 2 insertions(+), 1 deletions(-)

diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi
index 2d22eb3..8846051 100644
--- a/doc/lispref/processes.texi
+++ b/doc/lispref/processes.texi
@@ -260,7 +260,8 @@ system, much like text written into a file.  @xref{Coding 
Systems}.
 
 @defun call-process program &optional infile destination display &rest args
 This function calls @var{program} in a separate process and waits for
-it to finish.
+it to finish.  The current working directory of the subprocess is
+`default-directory'.
 
 The standard input for the process comes from file @var{infile} if
 @var{infile} is not @code{nil}, and from the null device otherwise.
-- 
1.7.2.3