From db9a8c9983066cfd5ebc7b50c47c118143c55a10 Mon Sep 17 00:00:00 2001 From: Corinna Vinschen Date: Tue, 3 Feb 2015 13:48:43 +0000 Subject: * Throughout, replace http with https as far as cygwin.com and sourceware.org URLs are concerned. * Throughout, simplify ulink expressions if the visible text is the URL anyway. * faq-programming.xml (faq.programming.dll-relocatable): Remove. * faq-setup.xml (faq.setup.name-with-space): Change for 1.7.34. (faq.setup.home): Ditto. * faq-using.xml (faq.using.printing): Clarify old links and availability of a2ps and file. (faq.using.xemacs): Drop outdated version info and pointers to native XEmacs. (faq.using.ntemacs): Remove. * faq-what.xml (faq.what.what): Rephrase to reflect reality. (faq.what.supported): Ditto. (faq.what.who): Rephrase slightly. * legal.xml: Bump copyright. * setup-net.xml (internet-setup): Fix references to setup executables. --- winsup/doc/faq-using.xml | 171 ++++++++--------------------------------------- 1 file changed, 29 insertions(+), 142 deletions(-) (limited to 'winsup/doc/faq-using.xml') diff --git a/winsup/doc/faq-using.xml b/winsup/doc/faq-using.xml index 18c6c4ed7..3b6694df4 100644 --- a/winsup/doc/faq-using.xml +++ b/winsup/doc/faq-using.xml @@ -25,7 +25,7 @@ installed. Scroll down to locate the missing package, for instance For a detailed explanation of the general problem, and how to extend it to other missing DLLs and identify their containing packages, see -http://cygwin.com/ml/cygwin/2002-01/msg01619.html. +. @@ -50,7 +50,7 @@ will slow things down tremendously if it does not exist. (sshd, inetd, etc), then it depends on the method used to switch to another user. This problem as well as its solution is described in detail in the Cygwin User's Guide, see -. +. Workarounds include using public network share that does not require authentication (for non-critical files), providing your password to a @@ -238,8 +238,9 @@ currently installed as part of the sh-utils, but again, it does not work. ssh username@localhost as a su replacement. -For some technical background into why su doesn't work, read -http://www.cygwin.com/ml/cygwin/2003-06/msg00897.html and +For some technical background into why su doesn't +work, read + and related messages. @@ -274,7 +275,7 @@ for memory cards or USB sticks to exchange pictures... For other cases, understand that Cygwin attempts to show UNIX permissions based on the security features of Windows, so the Windows ACLs are likely the source of your problem. See the Cygwin User's -Guide at +Guide at for more information on how Cygwin maps Windows permissions. @@ -326,25 +327,26 @@ to determine whether they are executable. How do I print under Cygwin? -lpr is available in the cygutils package. Some usage hints are available courtesy of Rodrigo Medina. +lpr is available in the cygutils package. Some usage hints are available courtesy of Rodrigo Medina. Jason Tishler has written a couple of messages that explain how to use a2ps (for nicely formatted text in PostScript) and ghostscript (to print PostScript files on non-PostScript Windows printers). Start at -http://cygwin.com/ml/cygwin/2001-04/msg00657.html. Note that the -file command is now available as part of Cygwin setup. +. Note that +these are old mails and a2ps as well as +file are long available as part of the Cygwin distribution. -Alternatively, you can use the Windows print -command. (It does not seem to be available on Win9x.) Type +Alternatively, you can use the Windows print +command. Type bash$ print /\? -for usage instructions (note the ? must be escaped from the -shell). +for usage instructions (note the ? must be escaped +from the shell). -Finally, you can simply cat the file to the printer's share name: +Finally, you can simply cat the file to the printer's share name: bash$ cat myfile > //host/printer @@ -362,7 +364,7 @@ formfeed character to your file. Internationalization is a complex issue. The short answer is that Cygwin relies on the setting of the setting of LANG/LC_xxx environment variables. The long answer can be found in the User's Guide in the -section Internationalization +section Internationalization Cygwin uses UTF-8 by default. To use a different character set, you @@ -414,7 +416,7 @@ if you have one a single Cygwin installation, for example, if you update the Cygwin package without exiting all Cygwin apps (including services like sshd) beforehand. The only DLL that is sanctioned by the Cygwin project is the one that -you get by running setup.exe, +you get by running setup-x86.exe or setup-x86_64.exe, installed in a directory controlled by this program. If you have other versions on your system and desire help from the cygwin project, you should delete or rename all DLLs that are not installed by @@ -450,7 +452,7 @@ Can I bundle Cygwin with my product for free? Only if you comply with Cygwin's license very carefully. If you +url="https://cygwin.com/licensing.html">license very carefully. If you choose to distribute cygwin1.dll, you must be willing to distribute the exact source code used to build that copy of cygwin1.dll as per the terms of the GPL. If you ship applications that link with cygwin1.dll, @@ -485,7 +487,7 @@ installed distribution. Probably because there is nobody willing or able to maintain it. It takes time, and the priority for the Cygwin Team is the Cygwin package. The rest is a volunteer effort. Want to contribute? See -http://cygwin.com/setup.html. +. @@ -569,7 +571,7 @@ of your current Cygwin session. You can change the default cygdrive prefix and whether it is binmode or textmode using the /etc/fstab file as well. See the Cygwin User's Guide at -http://cygwin.com/cygwin-ug-net/using.html#mount-table + for more details. @@ -618,7 +620,7 @@ of poorly written firewall-type software that causes things to break. Note that with many of these products, simply disabling the firewall does not remove these changes; it must be completely uninstalled. -See also +See also for a list of applications that have been known, at one time or another, to interfere with the normal functioning of Cygwin. @@ -652,7 +654,7 @@ configuration fails. To help with this problem, Cygwin supports case sensitivity starting with Cygwin 1.7.0. For a detailed description how to use that feature see the Cygwin User's Guilde at -http://cygwin.com/cygwin-ug-net/using-specialnames.html. +. @@ -672,7 +674,7 @@ letters 'aux' in it will hang. At least that's what happens when using native Windows tools. Cygwin 1.7.0 and later can deal with these filenames just fine. Again, see the User's Guide at -http://cygwin.com/cygwin-ug-net/using-specialnames.html + for a detailed description of what's possible with filenames and what is not. @@ -768,7 +770,7 @@ contents are exempt from scanning. In a default installation, this would be C:\cygwin\bin. Obviously, this could be exploited by a hostile non-Cygwin program, so do this at your own risk. -See also +See also for a list of applications that have been known, at one time or another, to interfere with the normal functioning of Cygwin. @@ -781,7 +783,7 @@ interfere with the normal functioning of Cygwin. Yes. Install the emacs package. This provides everything you need in order to run GNU emacs in a terminal window. If you also want to be able to use the X11 -(http://x.cygwin.com/) +() GUI, install the emacs-X11 package. In either case, you run emacs by typing 'emacs' or '/usr/bin/emacs'. @@ -793,7 +795,7 @@ typing 'emacs' or '/usr/bin/emacs'. Yes. It can be used in three different modes: -X11 (http://x.cygwin.com/) GUI +X11 () GUI You have to set the DISPLAY environment variable before starting xemacs. @@ -815,127 +817,12 @@ before starting xemacs. bash$ xemacs -nw -The current stable Cygwin version of XEmacs is 21.4.x. But there is also a -Cygwin test release version (21.5.x) available for download via setup.exe. - To use all the standard packages with XEmacs you should download the following two packages: xemacs-sumo - XEmacs standard packages xemacs-mule-sumo - XEmacs MULE (MUlti Lingual Emacs) packages -An alternative native distribution of XEmacs for -Windows based systems can be downloaded from -http://xemacs.org/Download/win32/index.html. -It uses an InnoSetup Kit based installer. - - - -What about NT Emacs? - - -If you want GNU Emacs with a native Microsoft GUI interface, -then you can either use XEmacs (see above), or native -NT Emacs: see section -Where can I get pre-compiled versions? in NT Emacs FAQ. - - -NT Emacs uses the Windows command shell by default. Since it is not a -Cygwin application, it has no knowledge of Cygwin mounts. With those -points in mind, you need to add the following code to your ~/.emacs -(or ~/_emacs) file in order to use Cygwin bash. This is particularly useful -for the JDEE package (http://jdee.sunsite.dk/). The following -settings are for Emacs 21.1: - - - - ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; - ;; Initial setup - ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; - - ;; This assumes that Cygwin is installed in C:\cygwin (the - ;; default) and that C:\cygwin\bin is not already in your - ;; Windows Path (it generally should not be). - - (setq exec-path (cons "C:/cygwin/bin" exec-path)) - (setenv "PATH" (concat "C:\\cygwin\\bin;" (getenv "PATH"))) - - ;; LOGNAME and USER are expected in many Emacs packages - ;; Check these environment variables. - - (if (and (null (getenv "USER")) - ;; Windows includes variable USERNAME, which is copied to - ;; LOGNAME and USER respectively. - (getenv "USERNAME")) - (setenv "USER" (getenv "USERNAME"))) - - (if (and (getenv "LOGNAME") - ;; Bash shell defines only LOGNAME - (null (getenv "USER"))) - (setenv "USER" (getenv "LOGNAME"))) - - (if (and (getenv "USER") - (null (getenv "LOGNAME"))) - (setenv "LOGNAME" (getenv "USER"))) - - ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; - ;; (A) M-x shell: This change M-x shell permanently - ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; - - ;; Would call Windows command interpreter. Change it. - - (setq shell-file-name "bash") - (setenv "SHELL" shell-file-name) - (setq explicit-shell-file-name shell-file-name) - - ;; Remove C-m (^M) characters that appear in output - - (add-hook 'comint-output-filter-functions - 'comint-strip-ctrl-m) - - ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; - ;; (B) *OR* call following function with M-x my-bash - ;; The M-x shell would continue to run standard Windows shell - ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; - - (defun my-bash (&optional buffer) - "Run Cygwin Bash shell in optional BUFFER; default *shell-bash*." - (autoload 'comint-check-proc "comint") - (interactive - (let ((name "*shell-bash*")) - (if current-prefix-arg - (setq name (read-string - (format "Cygwin shell buffer (default %s): " name) - (not 'initial-input) - (not 'history) - name))) - (list name))) - (or buffer - (setq buffer "*shell-bash*")) - (if (comint-check-proc buffer) - (pop-to-buffer buffer) - (let* ((shell-file-name "bash") - (explicit-shell-file-name shell-file-name) - (explicit-sh-args '("--login" "-i")) - (explicit-bash-args explicit-sh-args) - (w32-quote-process-args ?\"));; Use Cygwin quoting rules. - (shell buffer) - ;; By default Emacs sends "\r\n", but bash wants plain "\n" - (set-buffer-process-coding-system 'undecided-dos 'undecided-unix) - ;; With TAB completion, add slash path separator, none to filenames - (make-local-variable 'comint-completion-addsuffix) - (setq comint-completion-addsuffix '("/" . "")) - ;; This variable is local to buffer - (setq comint-prompt-regexp "^[ \n\t]*[$] ?")))) - - - -If you want NT Emacs to understand Cygwin paths, get -cygwin-mount.el from http://www.emacswiki.org/elisp/index.html. - -Note that all of this ``just works'' if you use the Cygwin port of -Emacs or XEmacs from Cygwin Setup. - @@ -974,7 +861,7 @@ file: Alternatively, use Windows shortcuts as symlinks. See the CYGWIN environment variable option "winsymlinks" -http://cygwin.com/cygwin-ug-net/using-cygwinenv.html + @@ -1065,7 +952,7 @@ such as this when trying to start a Tk app: Then you need to start an X server, or if one is already running, set the DISPLAY variable to the proper value. The Cygwin distribution -includes an X server; please see the Cygwin/X User Guide +includes an X server; please see the Cygwin/X User Guide for installation and startup instructions. @@ -1223,7 +1110,7 @@ such as virtual memory paging and file caching. ones undoes the effects of rebaseall and often causes fork() failures to reappear. If so, just run rebaseall again. - See the + See the process creation section of the User's Guide for the technical reasons it is so difficult to make fork() work reliably. -- cgit v1.2.3