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

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

[Jari Aalto]

Package: emacs
Version: 23.2+1-5.1
Severity: wishlist

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:

    ;; Q: What determines the run directory of this command?
    (call-process "pwd" nil (current-buffer))

-- System Information
Debian Release: squeeze/sid
  APT Prefers testing
  APT policy: (990, testing) (500, unstable) (1, experimental)
Architecture: amd64
Kernel: Linux picasso 2.6.32-5-amd64 #1 SMP Fri Sep 17 21:50:19 UTC 2010 x86_64 GNU/Linux
Locale: LANG=en_DK.UTF-8

-- Versions of packages `emacs depends on'.
Depends:
emacs23         23.2+1-5.1      GNU Emacs is the extensible self-documenting 
emacs23-lucid   23.2+1-5.1      GNU Emacs is the extensible self-documenting 
emacs23-nox     23.2+1-5.1      GNU Emacs is the extensible self-documenting 

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

[Glenn Morris]

> 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::).

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

[Jari Aalto]

[-- Attachment #1: Type: text/plain, Size: 1358 bytes --]

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'.


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-processes.texi-Synchronous-Processes-In-call-process.patch --]
[-- Type: text/x-diff, Size: 1149 bytes --]

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

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

[Lars Magne Ingebrigtsen]

Jari Aalto <jari.aalto@cante.net> writes:

> +it to finish.  The current working directory of the subprocess is
> +`default-directory'.

I've applied something similar to the Emacs trunk.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/