Mercurial > hg > xemacs-beta
annotate lisp/win32-native.el @ 2367:ecf1ebac70d8
[xemacs-hg @ 2004-11-04 23:05:23 by ben]
commit mega-patch
configure.in: Turn off -Winline and -Wchar-subscripts.
Use the right set of cflags when compiling modules.
Rewrite ldap configuration to separate the inclusion of lber
(needed in recent Cygwin) from the basic checks for the
needed libraries.
add a function for MAKE_JUNK_C; initially code was added to
generate xemacs.def using this, but it will need to be rewritten.
add an rm -f for junk.c to avoid weird Cygwin bug with cp -f onto
an existing file.
Sort list of auto-detected functions and eliminate unused checks for
stpcpy, setlocale and getwd.
Add autodetection of Cygwin scanf problems
BETA: Rewrite section on configure to indicate what flags are important
and what not.
digest-doc.c, make-dump-id.c, profile.c, sorted-doc.c: Add proper decls for main().
make-msgfile.c: Document that this is old junk.
Move proposal to text.c.
make-msgfile.lex: Move proposal to text.c.
make-mswin-unicode.pl: Convert error-generating code so that the entire message will
be seen as a single unrecognized token.
mule/mule-ccl.el: Update docs.
lispref/mule.texi: Update CCL docs.
ldap/eldap.c: Mule-ize.
Use EXTERNAL_LIST_LOOP_2 instead of deleted EXTERNAL_LIST_LOOP.
* XEmacs 21.5.18 "chestnut" is released.
---------------------------------------------------------------
MULE-RELATED WORK:
---------------------------------------------------------------
---------------------------
byte-char conversion
---------------------------
buffer.c, buffer.h, insdel.c, text.c: Port FSF algorithm for byte-char conversion, replacing broken
previous version. Track the char position of the gap. Add
functions to do char-byte conversion downwards as well as upwards.
Move comments about algorithm workings to internals manual.
---------------------------
work on types
---------------------------
alloc.c, console-x-impl.h, dump-data.c, dump-data.h, dumper.c, dialog-msw.c, dired-msw.c, doc.c, editfns.c, esd.c, event-gtk.h, event-msw.c, events.c, file-coding.c, file-coding.h, fns.c, glyphs-eimage.c, glyphs-gtk.c, glyphs-msw.c, glyphs-shared.c, glyphs-x.c, glyphs.c, glyphs.h, gui.c, hpplay.c, imgproc.c, intl-win32.c, lrecord.h, lstream.c, keymap.c, lisp.h, libsst.c, linuxplay.c, miscplay.c, miscplay.h, mule-coding.c, nas.c, nt.c, ntheap.c, ntplay.c, objects-msw.c, objects-tty.c, objects-x.c, print.c, process-nt.c, process.c, redisplay.h, select-common.h, select-gtk.c, select-x.c, sgiplay.c, sound.c, sound.h, sunplay.c, sysfile.h, sysdep.c, syswindows.h, text.c, unexnt.c, win32.c, xgccache.c: Further work on types. This creates a full set of types for all
the basic semantics of `char' that I have so far identified, so that
its semantics can always be identified for the purposes of proper
Mule-safe code, and the raw use of `char' always avoided.
(1) More type renaming, for consistency of naming.
Char_ASCII -> Ascbyte
UChar_ASCII -> UAscbyte
Char_Binary -> CBinbyte
UChar_Binary -> Binbyte
SChar_Binary -> SBinbyte
(2) Introduce Rawbyte, CRawbyte, Boolbyte, Chbyte, UChbyte, and
Bitbyte and use them.
(3) New types Itext, Wexttext and Textcount for separating out
the concepts of bytes and textual units (different under UTF-16
and UTF-32, which are potential internal encodings).
(4) qxestr*_c -> qxestr*_ascii.
lisp.h: New; goes with other qxe() functions. #### Maybe goes in a
different section.
lisp.h: Group generic int-type defs together with EMACS_INT defs.
lisp.h: * lisp.h (WEXTTEXT_IS_WIDE)
New defns.
lisp.h: New type to replace places where int occurs as a boolean.
It's signed because occasionally people may want to use -1 as
an error value, and because unsigned ints are viral -- see comments
in the internals manual against using them.
dynarr.c: int -> Bytecount.
---------------------------
Mule-izing
---------------------------
device-x.c: Partially Mule-ize.
dumper.c, dumper.h: Mule-ize. Use Rawbyte. Use stderr_out not printf. Use wext_*().
sysdep.c, syswindows.h, text.c: New Wexttext API for manipulation of external text that may be
Unicode (e.g. startup code under Windows).
emacs.c: Mule-ize. Properly deal with argv in external encoding.
Use wext_*() and Wexttext. Use Rawbyte.
#if 0 some old junk on SCO that is unlikely to be correct.
Rewrite allocation code in run-temacs.
emacs.c, symsinit.h, win32.c: Rename win32 init function and call it even earlier, to
initialize mswindows_9x_p even earlier, for use in startup code
(XEUNICODE_P).
process.c: Use _wenviron not environ under Windows, to get Unicode environment
variables.
event-Xt.c: Mule-ize drag-n-drop related stuff.
dragdrop.c, dragdrop.h, frame-x.c: Mule-ize.
text.h: Add some more stand-in defines for particular kinds of conversion;
use in Mule-ization work in frame-x.c etc.
---------------------------
Freshening
---------------------------
intl-auto-encap-win32.c, intl-auto-encap-win32.h: Regenerate.
---------------------------
Unicode-work
---------------------------
intl-win32.c, syswindows.h: Factor out common options to MultiByteToWideChar and
WideCharToMultiByte. Add convert_unicode_to_multibyte_malloc()
and convert_unicode_to_multibyte_dynarr() and use. Add stuff for
alloca() conversion of multibyte/unicode.
alloc.c: Use dfc_external_data_len() in case of unicode coding system.
alloc.c, mule-charset.c: Don't zero out and reinit charset Unicode tables. This fucks up
dump-time loading. Anyway, either we load them at dump time or
run time, never both.
unicode.c: Dump the blank tables as well.
---------------------------------------------------------------
DOCUMENTATION, MOSTLY MULE-RELATED:
---------------------------------------------------------------
EmacsFrame.c, emodules.c, event-Xt.c, fileio.c, input-method-xlib.c, mule-wnnfns.c, redisplay-gtk.c, redisplay-tty.c, redisplay-x.c, regex.c, sysdep.c: Add comment about Mule work needed.
text.h: Add more documentation describing why DFC routines were not written
to return their value. Add some other DFC documentation.
console-msw.c, console-msw.h: Add pointer to docs in win32.c.
emacs.c: Add comments on sources of doc info.
text.c, charset.h, unicode.c, intl-win32.c, intl-encap-win32.c, text.h, file-coding.c, mule-coding.c: Collect background comments and related to text matters and
internationalization, and proposals for work to be done, in text.c
or Internals manual, stuff related to specific textual API's in
text.h, and stuff related to internal implementation of Unicode
conversion in unicode.c. Put lots of pointers to the comments to
make them easier to find.
s/mingw32.h, s/win32-common.h, s/win32-native.h, s/windowsnt.h, win32.c: Add bunches of new documentation on the different kinds of
builds and environments under Windows and how they work.
Collect this info in win32.c. Add pointers to these docs in
the relevant s/* files.
emacs.c: Document places with long comments.
Remove comment about exiting, move to internals manual, put
in pointer.
event-stream.c: Move docs about event queues and focus to internals manual, put
in pointer.
events.h: Move docs about event stream callbacks to internals manual, put
in pointer.
profile.c, redisplay.c, signal.c: Move documentation to the Internals manual.
process-nt.c: Add pointer to comment in win32-native.el.
lisp.h: Add comments about some comment conventions.
lisp.h: Add comment about the second argument.
device-msw.c, redisplay-msw.c: @@#### comments are out-of-date.
---------------------------------------------------------------
PDUMP WORK (MOTIVATED BY UNICODE CHANGES)
---------------------------------------------------------------
alloc.c, buffer.c, bytecode.c, console-impl.h, console.c, device.c, dumper.c, lrecord.h, elhash.c, emodules.h, events.c, extents.c, frame.c, glyphs.c, glyphs.h, mule-charset.c, mule-coding.c, objects.c, profile.c, rangetab.c, redisplay.c, specifier.c, specifier.h, window.c, lstream.c, file-coding.h, file-coding.c: PDUMP:
Properly implement dump_add_root_block(), which never worked before,
and is necessary for dumping Unicode tables.
Pdump name changes for accuracy:
XD_STRUCT_PTR -> XD_BLOCK_PTR.
XD_STRUCT_ARRAY -> XD_BLOCK_ARRAY.
XD_C_STRING -> XD_ASCII_STRING.
*_structure_* -> *_block_*.
lrecord.h: some comments added about
dump_add_root_block() vs dump_add_root_block_ptr().
extents.c: remove incorrect comment about pdump problems with gap array.
---------------------------------------------------------------
ALLOCATION
---------------------------------------------------------------
abbrev.c, alloc.c, bytecode.c, casefiddle.c, device-msw.c, device-x.c, dired-msw.c, doc.c, doprnt.c, dragdrop.c, editfns.c, emodules.c, file-coding.c, fileio.c, filelock.c, fns.c, glyphs-eimage.c, glyphs-gtk.c, glyphs-msw.c, glyphs-x.c, gui-msw.c, gui-x.c, imgproc.c, intl-win32.c, lread.c, menubar-gtk.c, menubar.c, nt.c, objects-msw.c, objects-x.c, print.c, process-nt.c, process-unix.c, process.c, realpath.c, redisplay.c, search.c, select-common.c, symbols.c, sysdep.c, syswindows.h, text.c, text.h, ui-byhand.c: New macros {alloca,xnew}_{itext,{i,ext,raw,bin,asc}bytes} for
more convenient allocation of these commonly requested items.
Modify functions to use alloca_ibytes, alloca_array, alloca_extbytes,
xnew_ibytes, etc. also XREALLOC_ARRAY, xnew.
alloc.c: Rewrite the allocation functions to factor out repeated code.
Add assertions for freeing dumped data.
lisp.h: Moved down and consolidated with other allocation stuff.
lisp.h, dynarr.c: New functions for allocation that's very efficient when mostly in
LIFO order.
lisp.h, text.c, text.h: Factor out some stuff for general use by alloca()-conversion funs.
text.h, lisp.h: Fill out convenience routines for allocating various kinds of
bytes and put them in lisp.h. Use them in place of xmalloc(),
ALLOCA().
text.h: Fill out the convenience functions so the _MALLOC() kinds match
the alloca() kinds.
---------------------------------------------------------------
ERROR-CHECKING
---------------------------------------------------------------
text.h: Create ASSERT_ASCTEXT_ASCII() and ASSERT_ASCTEXT_ASCII_LEN()
from similar Eistring checkers and change the Eistring checkers to
use them instead.
---------------------------------------------------------------
MACROS IN LISP.H
---------------------------------------------------------------
lisp.h: Redo GCPRO declarations. Create a "base" set of functions that can
be used to generate any kind of gcpro sets -- regular, ngcpro,
nngcpro, private ones used in GC_EXTERNAL_LIST_LOOP_2.
buffer.c, callint.c, chartab.c, console-msw.c, device-x.c, dialog-msw.c, dired.c, extents.c, ui-gtk.c, rangetab.c, nt.c, mule-coding.c, minibuf.c, menubar-msw.c, menubar.c, menubar-gtk.c, lread.c, lisp.h, gutter.c, glyphs.c, glyphs-widget.c, fns.c, fileio.c, file-coding.c, specifier.c: Eliminate EXTERNAL_LIST_LOOP, which does not check for circularities.
Use EXTERNAL_LIST_LOOP_2 instead or EXTERNAL_LIST_LOOP_3
or EXTERNAL_PROPERTY_LIST_LOOP_3 or GC_EXTERNAL_LIST_LOOP_2
(new macro). Removed/redid comments on EXTERNAL_LIST_LOOP.
---------------------------------------------------------------
SPACING FIXES
---------------------------------------------------------------
callint.c, hftctl.c, number-gmp.c, process-unix.c: Spacing fixes.
---------------------------------------------------------------
FIX FOR GEOMETRY PROBLEM IN FIRST FRAME
---------------------------------------------------------------
unicode.c: Add workaround for newlib bug in sscanf() [should be fixed by
release 1.5.12 of Cygwin].
toolbar.c: bug fix for problem of initial frame being 77 chars wide on Windows.
will be overridden by my other ws.
---------------------------------------------------------------
FIX FOR LEAKING PROCESS HANDLES:
---------------------------------------------------------------
process-nt.c: Fixes for leaking handles. Inspired by work done by Adrian Aichner
<adrian@xemacs.org>.
---------------------------------------------------------------
FIX FOR CYGWIN BUG (Unicode-related):
---------------------------------------------------------------
unicode.c: Add workaround for newlib bug in sscanf() [should be fixed by
release 1.5.12 of Cygwin].
---------------------------------------------------------------
WARNING FIXES:
---------------------------------------------------------------
console-stream.c: `reinit' is unused.
compiler.h, event-msw.c, frame-msw.c, intl-encap-win32.c, text.h: Add stuff to deal with ANSI-aliasing warnings I got.
regex.c: Gather includes together to avoid warning.
---------------------------------------------------------------
CHANGES TO INITIALIZATION ROUTINES:
---------------------------------------------------------------
buffer.c, emacs.c, console.c, debug.c, device-x.c, device.c, dragdrop.c, emodules.c, eval.c, event-Xt.c, event-gtk.c, event-msw.c, event-stream.c, event-tty.c, events.c, extents.c, faces.c, file-coding.c, fileio.c, font-lock.c, frame-msw.c, glyphs-widget.c, glyphs.c, gui-x.c, insdel.c, lread.c, lstream.c, menubar-gtk.c, menubar-x.c, minibuf.c, mule-wnnfns.c, objects-msw.c, objects.c, print.c, scrollbar-x.c, search.c, select-x.c, text.c, undo.c, unicode.c, window.c, symsinit.h: Call reinit_*() functions directly from emacs.c, for clarity.
Factor out some redundant init code. Move disallowed stuff
that had crept into vars_of_glyphs() into complex_vars_of_glyphs().
Call init_eval_semi_early() from eval.c not in the middle of
vars_of_() in emacs.c since there should be no order dependency
in the latter calls.
---------------------------------------------------------------
ARMAGEDDON:
---------------------------------------------------------------
alloc.c, emacs.c, lisp.h, print.c: Rename inhibit_non_essential_printing_operations to
inhibit_non_essential_conversion_operations.
text.c: Assert on !inhibit_non_essential_conversion_operations.
console-msw.c, print.c: Don't do conversion in SetConsoleTitle or FindWindow to avoid
problems during armageddon. Put #errors for NON_ASCII_INTERNAL_FORMAT
in places where problems would arise.
---------------------------------------------------------------
CHANGES TO THE BUILD PROCEDURE:
---------------------------------------------------------------
config.h.in, s/cxux.h, s/usg5-4-2.h, m/powerpc.h: Add comment about correct ordering of this file.
Rearrange everything to follow this -- put all #undefs together
and before the s&m files. Add undefs for HAVE_ALLOCA, C_ALLOCA,
BROKEN_ALLOCA_IN_FUNCTION_CALLS, STACK_DIRECTION. Remove unused
HAVE_STPCPY, HAVE_GETWD, HAVE_SETLOCALE.
m/gec63.h: Deleted; totally broken, not used at all, not in FSF.
m/7300.h, m/acorn.h, m/alliant-2800.h, m/alliant.h, m/altos.h, m/amdahl.h, m/apollo.h, m/att3b.h, m/aviion.h, m/celerity.h, m/clipper.h, m/cnvrgnt.h, m/convex.h, m/cydra5.h, m/delta.h, m/delta88k.h, m/dpx2.h, m/elxsi.h, m/ews4800r.h, m/gould.h, m/hp300bsd.h, m/hp800.h, m/hp9000s300.h, m/i860.h, m/ibmps2-aix.h, m/ibmrs6000.h, m/ibmrt-aix.h, m/ibmrt.h, m/intel386.h, m/iris4d.h, m/iris5d.h, m/iris6d.h, m/irist.h, m/isi-ov.h, m/luna88k.h, m/m68k.h, m/masscomp.h, m/mg1.h, m/mips-nec.h, m/mips-siemens.h, m/mips.h, m/news.h, m/nh3000.h, m/nh4000.h, m/ns32000.h, m/orion105.h, m/pfa50.h, m/plexus.h, m/pmax.h, m/powerpc.h, m/pyrmips.h, m/sequent-ptx.h, m/sequent.h, m/sgi-challenge.h, m/symmetry.h, m/tad68k.h, m/tahoe.h, m/targon31.h, m/tekxd88.h, m/template.h, m/tower32.h, m/tower32v3.h, m/ustation.h, m/vax.h, m/wicat.h, m/xps100.h: Delete C_ALLOCA, HAVE_ALLOCA, STACK_DIRECTION,
BROKEN_ALLOCA_IN_FUNCTION_CALLS. All of this is auto-detected.
When in doubt, I followed recent FSF sources, which also have
these things deleted.
| author | ben |
|---|---|
| date | Thu, 04 Nov 2004 23:08:28 +0000 |
| parents | eeb607577f17 |
| children | 308d34e9f07d |
| rev | line source |
|---|---|
| 611 | 1 ;;; win32-native.el --- Lisp routines when running on native MS Windows. |
| 442 | 2 |
| 3 ;; Copyright (C) 1994 Free Software Foundation, Inc. | |
| 2367 | 4 ;; Copyright (C) 2000, 2004 Ben Wing. |
| 442 | 5 |
| 6 ;; Maintainer: XEmacs Development Team | |
| 7 ;; Keywords: mouse, dumped | |
| 8 | |
| 9 ;; This file is part of XEmacs. | |
| 10 | |
| 11 ;; XEmacs is free software; you can redistribute it and/or modify it | |
| 12 ;; under the terms of the GNU General Public License as published by | |
| 13 ;; the Free Software Foundation; either version 2, or (at your option) | |
| 14 ;; any later version. | |
| 15 | |
| 16 ;; XEmacs is distributed in the hope that it will be useful, but | |
| 17 ;; WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
| 19 ;; General Public License for more details. | |
| 20 | |
| 21 ;; You should have received a copy of the GNU General Public License | |
| 22 ;; along with XEmacs; see the file COPYING. If not, write to the | |
| 23 ;; Free Software Foundation, 59 Temple Place - Suite 330, | |
| 24 ;; Boston, MA 02111-1307, USA. | |
| 25 | |
| 611 | 26 ;;; Synched up with: Not in FSF. |
| 442 | 27 ;;; (FSF has stuff in w32-fns.el and term/w32-win.el.) |
| 28 | |
| 29 ;;; Commentary: | |
| 30 | |
| 31 ;; This file is dumped with XEmacs for MS Windows (without cygwin). | |
| 611 | 32 ;; It is for stuff that is used specifically when `system-type' eq |
| 33 ;; `windows-nt' (i.e. also applies to MinGW), and has nothing to do | |
| 34 ;; with the `mswindows' device type. Thus, it probably applies in | |
| 35 ;; non-interactive mode as well, and it DOES NOT APPLY to Cygwin. | |
| 442 | 36 |
| 611 | 37 ;; Based (originally) on NT Emacs version by Geoff Voelker |
| 38 ;; (voelker@cs.washington.edu) | |
| 442 | 39 ;; Ported to XEmacs by Marc Paquette <marcpa@cam.org> |
| 40 ;; Largely modified by Kirill M. Katsnelson <kkm@kis.ru> | |
| 611 | 41 ;; Rewritten from scratch by Ben Wing <ben@xemacs.org>. No code in common |
| 42 ;; with FSF. | |
| 442 | 43 |
| 44 ;;; Code: | |
| 45 | |
| 46 ;; For appending suffixes to directories and files in shell | |
| 47 ;; completions. This screws up cygwin users so we leave it out for | |
| 48 ;; now. Uncomment this if you only ever want to use cmd. | |
| 49 | |
| 50 ;(defun nt-shell-mode-hook () | |
| 51 ; (setq comint-completion-addsuffix '("\\" . " ") | |
| 52 ; comint-process-echoes t)) | |
| 53 ;(add-hook 'shell-mode-hook 'nt-shell-mode-hook) | |
| 54 | |
| 55 ;; Use ";" instead of ":" as a path separator (from files.el). | |
| 56 (setq path-separator ";") | |
| 57 | |
| 58 ;; Set the grep regexp to match entries with drive letters. | |
| 776 | 59 (defvar grep-regexp-alist) |
| 442 | 60 (setq grep-regexp-alist |
| 61 '(("^\\(\\([a-zA-Z]:\\)?[^:( \t\n]+\\)[:( \t]+\\([0-9]+\\)[:) \t]" 1 3))) | |
| 62 | |
| 611 | 63 (defvar mswindows-system-shells '("cmd" "cmd.exe" "command" "command.com" |
| 64 "4nt" "4nt.exe" "4dos" "4dos.exe" | |
| 65 "ndos" "ndos.exe") | |
| 66 "List of strings recognized as Windows NT/9X system shells. | |
| 67 These are shells with native semantics, e.g. they use `/c', not '-c', | |
| 68 to pass a command in.") | |
| 69 | |
| 70 (defun mswindows-system-shell-p (shell-name) | |
| 71 (member (downcase (file-name-nondirectory shell-name)) | |
| 72 mswindows-system-shells)) | |
| 73 | |
| 74 (defun init-mswindows-at-startup () | |
| 75 ;; shell-file-name is initialized in the C code (callproc.c) from | |
| 76 ;; SHELL or COMSPEC. | |
| 77 ;; #### If only shell-command-switch could be a function. But there | |
| 78 ;; is code littered around that uses it. | |
| 79 ;; #### Maybe we should set a symbol-value handler on `shell-file-name' | |
| 80 ;; that automatically sets shell-command-switch? | |
| 81 (if (mswindows-system-shell-p shell-file-name) | |
| 82 (setq shell-command-switch "/c"))) | |
| 83 | |
| 2367 | 84 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; |
| 85 ;; ;; | |
| 86 ;; Quoting process args ;; | |
| 87 ;; ;; | |
| 88 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | |
| 89 | |
| 90 ;; Converting a bunch of args into a single command line or vice-versa is | |
| 91 ;; extremely hairy due to the quoting conventions needed. There is in fact | |
| 92 ;; code that does this in the CRT, and perhaps we should look at it and | |
| 93 ;; follow the logic. | |
| 94 | |
| 95 ;; Here is some further info from MSDN, discovered *AFTER* the actual code | |
| 96 ;; below was written, and hence the code may not follow what it should. | |
| 97 ;; !!#### But this is definitely something to be fixed up. The article is | |
| 98 ;; called "Parsing C++ Command-Line Arguments", Visual Tools and Langs -> | |
| 99 ;; Visual Studio -> Visual C++ -> Reference -> C/C++ Lang and ... -> C++ | |
| 100 ;; Lang Ref -> Basic Concepts -> Startup and Termination -> Program | |
| 101 ;; Startup: the main Function. | |
| 102 | |
| 103 ;; Microsoft Specific | |
| 104 ;; | |
| 105 ;; Microsoft C/C++ startup code uses the following rules when interpreting | |
| 106 ;; arguments given on the operating system command line: | |
| 107 ;; | |
| 108 ;; Arguments are delimited by white space, which is either a space or a tab. | |
| 109 ;; | |
| 110 ;; The caret character (^) is not recognized as an escape character or | |
| 111 ;; delimiter. The character is handled completely by the command-line parser | |
| 112 ;; in the operating system before being passed to the argv array in the | |
| 113 ;; program. | |
| 114 ;; | |
| 115 ;; A string surrounded by double quotation marks ("string") is interpreted as | |
| 116 ;; a single argument, regardless of white space contained within. A quoted | |
| 117 ;; string can be embedded in an argument. | |
| 118 ;; | |
| 119 ;; A double quotation mark preceded by a backslash ( \") is interpreted as a | |
| 120 ;; literal double quotation mark character ("). | |
| 121 ;; | |
| 122 ;; Backslashes are interpreted literally, unless they immediately precede a | |
| 123 ;; double quotation mark. | |
| 124 ;; | |
| 125 ;; If an even number of backslashes is followed by a double quotation mark, | |
| 126 ;; one backslash is placed in the argv array for every pair of backslashes, | |
| 127 ;; and the double quotation mark is interpreted as a string delimiter. | |
| 128 ;; | |
| 129 ;; If an odd number of backslashes is followed by a double quotation mark, one | |
| 130 ;; backslash is placed in the argv array for every pair of backslashes, and | |
| 131 ;; the double quotation mark is "escaped" by the remaining backslash, | |
| 132 ;; causing a literal double quotation mark (") to be placed in argv. | |
| 133 ;; | |
| 134 ;; The following program demonstrates how command-line arguments are passed: | |
| 135 ;; | |
| 136 ;; include <iostream.h> | |
| 137 ;; | |
| 138 ;; void main( int argc, // Number of strings in array argv | |
| 139 ;; char *argv[], // Array of command-line argument strings | |
| 140 ;; char *envp[] ) // Array of environment variable strings | |
| 141 ;; { | |
| 142 ;; int count; | |
| 143 ;; | |
| 144 ;; // Display each command-line argument. | |
| 145 ;; cout << "\nCommand-line arguments:\n"; | |
| 146 ;; for( count = 0; count < argc; count++ ) | |
| 147 ;; cout << " argv[" << count << "] " | |
| 148 ;; << argv[count] << "\n"; | |
| 149 ;; } | |
| 150 ;; | |
| 151 ;; Table 2.2 shows example input and expected output, demonstrating the rules | |
| 152 ;; in the preceding list. | |
| 153 ;; | |
| 154 ;; Table 2.2 | |
| 155 ;; | |
| 156 ;; Command-Line Input argv[1] argv[2] argv[3] | |
| 157 ;; ------------------------------------------ | |
| 158 ;; "abc" d e abc d e | |
| 159 ;; | |
| 160 ;; a\\\b d"e f"g h a\\\b de fg h | |
| 161 ;; | |
| 162 ;; a\\\"b c d a\"b c d | |
| 163 ;; | |
| 164 ;; a\\\\"b c" d e a\\b c d e | |
| 165 ;; | |
| 166 ;; END Microsoft Specific | |
| 167 ;; | |
| 168 ;; note: for pulling apart an arg: | |
| 169 ;; each arg consists of either | |
| 170 | |
| 171 ;; something surrounded by single quotes | |
| 172 | |
| 173 ;; or | |
| 174 | |
| 175 ;; one or more of | |
| 176 | |
| 177 ;; 1. a non-ws, non-" char | |
| 178 ;; 2. a section of double-quoted text | |
| 179 ;; 3. a section of double-quoted text with end-of-string instead of the final | |
| 180 ;; quote. | |
| 181 | |
| 182 ;; 2 and 3 get handled together. | |
| 183 | |
| 184 ;; quoted text is one of | |
| 185 ;; | |
| 186 ;; 1. quote + even number of backslashes + quote, or | |
| 187 ;; 2. quote + non-greedy anything + non-backslash + even number of | |
| 188 ;; backslashes + quote. | |
| 189 | |
| 190 ;; we need to separate the two because we unfortunately have no non-greedy | |
| 191 ;; ? operator. (urk! we actually do, but it wasn't documented.) --ben | |
| 192 | |
| 193 ;; if you want to mess around, keep this test case in mind: | |
| 194 | |
| 195 ;; this string | |
| 196 | |
| 197 ;; " as'f 'FOO BAR' '' \"\" \"asdf \\ \\\" \\\\\\\" asdfasdf\\\\\" foo\" " | |
| 198 | |
| 199 ;; should tokenize into this: | |
| 200 | |
| 201 ;; (" " "as'f" " " "'FOO BAR' " "'' " "\"\"" " " "\"asdf \\ \\\" \\\\\\\" asdfasdf\\\\\"" " " "foo" "\" ") | |
| 202 | |
| 442 | 203 |
| 204 (defvar debug-mswindows-process-command-lines nil | |
| 205 "If non-nil, output debug information about the command lines constructed. | |
| 206 This can be useful if you are getting process errors where the arguments | |
| 207 to the process appear to be getting passed incorrectly.") | |
| 208 | |
| 209 ;; properly quotify one arg for the vc runtime argv constructor. | |
| 210 (defun mswindows-quote-one-vc-runtime-arg (arg &optional quote-shell) | |
| 211 ;; we mess with any arg with whitespace, quotes, or globbing chars in it. | |
| 212 ;; we also include shell metachars if asked. | |
| 213 ;; note that \ is NOT included! it's perfectly OK to include an | |
| 214 ;; arg like c:\ or c:\foo. | |
| 611 | 215 (cond ((equal arg "") "\"\"") |
| 216 ((string-match | |
| 217 (if quote-shell "[ \t\n\r\f*?\"<>|&^%]" "[ \t\n\r\f*?\"]") | |
| 218 arg) | |
| 219 ;; handle nested quotes, possibly preceded by backslashes | |
| 220 (setq arg (replace-in-string arg "\\([\\]*\\)\"" "\\1\\1\\\\\"")) | |
| 221 ;; handle trailing backslashes | |
| 222 (setq arg (replace-in-string arg "\\([\\]+\\)$" "\\1\\1")) | |
| 223 (concat "\"" arg "\"")) | |
| 224 (t arg))) | |
| 442 | 225 |
| 226 (defun mswindows-quote-one-simple-arg (arg &optional quote-shell) | |
| 227 ;; just put double quotes around args with spaces (and maybe shell | |
| 228 ;; metachars). | |
| 611 | 229 (cond ((equal arg "") "\"\"") |
| 230 ((string-match | |
| 231 (if quote-shell "[ \t\n\r\f*?\"<>|&^%]" "[ \t\n\r\f*?]") | |
| 232 arg) | |
| 233 (concat "\"" arg "\"")) | |
| 234 (t arg))) | |
| 442 | 235 |
| 236 (defun mswindows-quote-one-command-arg (arg) | |
| 237 ;; quote an arg to get it past COMMAND.COM/CMD.EXE: need to quote shell | |
| 238 ;; metachars with ^. | |
| 611 | 239 (cond ((equal arg "") "\"\"") |
| 240 (t (replace-in-string "[<>|&^%]" "^\\1" arg)))) | |
| 442 | 241 |
| 242 (defun mswindows-construct-verbatim-command-line (program args) | |
| 243 (mapconcat #'identity args " ")) | |
| 244 | |
| 245 ;; for use with either standard VC++ compiled programs or Cygwin programs, | |
| 246 ;; which emulate the same behavior. | |
| 247 (defun mswindows-construct-vc-runtime-command-line (program args) | |
| 248 (mapconcat #'mswindows-quote-one-vc-runtime-arg args " ")) | |
| 249 | |
| 250 ;; this regexp actually separates the arg into individual args, like a | |
| 251 ;; shell (such as sh) does, but using vc-runtime rules. it's easy to | |
| 252 ;; derive the tokenizing regexp from it, and that's exactly what i did. | |
| 253 ;; but oh was it hard to get this first regexp right. --ben | |
| 254 ;(defvar mswindows-match-one-cmd-exe-arg-regexp | |
| 255 ; (concat | |
| 256 ; "^\\(" | |
| 257 ; "'\\([\\]*\\)\\2'" "\\|" | |
| 258 ; "'.*?[^\\]\\(\\([\\]*\\)\\4'\\)" "\\|" | |
| 259 ; "\\(" | |
| 260 ; "[^ \t\n\r\f\v\"]" "\\|" | |
| 261 ; "\"\\([\\]*\\)\\6\"" "\\|" | |
| 262 ; "\".*?[^\\]\\(\\([\\]*\\)\\8\"\\|$\\)" | |
| 263 ; "\\)+" | |
| 264 ; "\\)" | |
| 265 ; "\\([ \t\n\r\f\v]+\\|$\\)")) | |
| 266 | |
| 267 (defvar mswindows-match-one-cmd-exe-token-regexp | |
| 268 (concat | |
| 269 "^\\(" | |
| 270 "[ \t\n\r\f\v]+" "\\|" | |
| 271 "'\\([\\]*\\)\\2'" "\\([ \t\n\r\f\v]+\\|$\\)" "\\|" | |
| 272 "'.*?[^\\]\\(\\([\\]*\\)\\5'\\)" "\\([ \t\n\r\f\v]+\\|$\\)" "\\|" | |
| 273 "[^ \t\n\r\f\v\"]+" "\\|" | |
| 274 "\"\\([\\]*\\)\\7\"" "\\|" | |
| 275 "\".*?[^\\]\\(\\([\\]*\\)\\9\"\\|$\\)" | |
| 276 "\\)")) | |
| 277 | |
| 278 (defun mswindows-construct-command-command-line (program args) | |
| 279 ;; for use with COMMAND.COM and CMD.EXE: | |
| 280 ;; for each arg, tokenize it into quoted and non-quoted sections; | |
| 281 ;; then quote all the shell meta-chars with ^; then put everything | |
| 282 ;; back together. the truly hard part is the tokenizing -- typically | |
| 283 ;; we get a single argument (the command to execute) and we have to | |
| 284 ;; worry about quotes that are backslash-quoted and such. | |
| 285 (mapconcat | |
| 286 #'(lambda (arg) | |
| 287 (mapconcat | |
| 288 #'(lambda (part) | |
| 289 (if (string-match "^'" part) | |
| 290 (replace-in-string part "\\([<>|^&%]\\)" "^\\1") | |
| 291 part)) | |
| 292 (let (parts) | |
| 293 (while (and (> (length arg) 0) | |
| 294 (string-match | |
| 295 mswindows-match-one-cmd-exe-token-regexp | |
| 296 arg)) | |
| 297 (push (match-string 0 arg) parts) | |
| 298 (setq arg (substring arg (match-end 0)))) | |
| 299 (if (> (length arg) 0) | |
| 300 (push arg parts)) | |
| 301 (nreverse parts)) | |
| 302 "")) | |
| 303 args " ")) | |
| 304 | |
| 305 (defvar mswindows-construct-process-command-line-alist | |
| 611 | 306 '( |
| 307 ;; at one point (pre-1.0), this was required for Cygwin bash. | |
| 308 ;; evidently, Cygwin changed its arg handling to work just like | |
| 309 ;; any standard VC program, so we no longer need it. | |
| 310 ;;("[\\/].?.?sh\\." . mswindows-construct-verbatim-command-line) | |
| 442 | 311 ("[\\/]command\\.com$" . mswindows-construct-command-command-line) |
| 312 ("[\\/]cmd\\.exe$" . mswindows-construct-command-command-line) | |
| 313 ("" . mswindows-construct-vc-runtime-command-line)) | |
| 314 "An alist for determining proper argument quoting given executable | |
| 315 file name. Car of each cons should be a string, a regexp against | |
| 316 which the file name is matched. Matching is case-insensitive but does | |
| 317 include the directory, so you should begin your regexp with [\\\\/] if | |
| 318 you don't want the directory to matter. Alternatively, the car can be | |
| 319 a function of one arg, which is called with the executable's name and | |
| 320 should return t if this entry should be processed. Cdr is a function | |
| 321 symbol, which is called with two args, the executable name and a list | |
| 322 of the args passed to it. It should return a string, which includes | |
| 323 the executable's args (but not the executable name itself) properly | |
| 324 quoted and pasted together. The list is matched in order, and the | |
| 325 first matching entry specifies how the processing will happen.") | |
| 326 | |
| 327 (defun mswindows-construct-process-command-line (args) | |
| 328 ;;Properly quote process ARGS for executing (car ARGS). | |
| 329 ;;Called from the C code. | |
| 330 (let ((fname (car args)) | |
| 331 (alist mswindows-construct-process-command-line-alist) | |
| 332 (case-fold-search t) | |
| 333 (return-me nil) | |
| 334 (assoc nil)) | |
| 335 (while (and alist | |
| 336 (null return-me)) | |
| 337 (setq assoc (pop alist)) | |
| 338 (if (if (stringp (car assoc)) | |
| 339 (string-match (car assoc) fname) | |
| 340 (funcall (car assoc) fname)) | |
| 341 (setq return-me (cdr assoc)))) | |
| 342 (let* ((called-fun (or return-me | |
| 343 #'mswindows-construct-vc-runtime-command-line)) | |
| 344 (retval | |
| 345 (let ((str (funcall called-fun fname (cdr args))) | |
| 346 (quoted-fname (mswindows-quote-one-simple-arg fname))) | |
| 347 (if (and str (> (length str) 0)) | |
| 348 (concat quoted-fname " " str) | |
| 349 quoted-fname)))) | |
| 350 (when debug-mswindows-process-command-lines | |
| 351 (debug-print "mswindows-construct-process-command-line called:\n") | |
| 352 (debug-print "received args: \n%s" | |
| 353 (let ((n -1)) | |
| 354 (mapconcat #'(lambda (arg) | |
| 355 (incf n) | |
| 356 (format " %d %s\n" n arg)) | |
| 357 args | |
| 358 ""))) | |
| 359 (debug-print "called fun %s\n" called-fun) | |
| 360 (debug-print "resulting command line: %s\n" retval)) | |
| 361 retval))) | |
| 362 | |
| 363 ;;; win32-native.el ends here |