diff options
Diffstat (limited to 'doc')
60 files changed, 5313 insertions, 2805 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am index 15f35ee6..c197ceb0 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -1,7 +1,11 @@ +SUBDIRS = man + +if HAVE_MAKEINFO +SUBDIRS += texinfo +endif + if USE_COLOR -SUBDIRS = man syntax texinfo -else -SUBDIRS = man texinfo +SUBDIRS += syntax endif -EXTRA_DIST = faq.html +dist_html_DATA = faq.html diff --git a/doc/Makefile.in b/doc/Makefile.in index 1e6086d6..4099cf73 100644 --- a/doc/Makefile.in +++ b/doc/Makefile.in @@ -1,9 +1,8 @@ -# Makefile.in generated by automake 1.11.6 from Makefile.am. +# Makefile.in generated by automake 1.13.3 from Makefile.am. # @configure_input@ -# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, -# 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software -# Foundation, Inc. +# Copyright (C) 1994-2013 Free Software Foundation, Inc. + # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, # with or without modifications, as long as this notice is preserved. @@ -14,24 +13,53 @@ # PARTICULAR PURPOSE. @SET_MAKE@ + VPATH = @srcdir@ -am__make_dryrun = \ - { \ - am__dry=no; \ +am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__make_running_with_option = \ + case $${target_option-} in \ + ?) ;; \ + *) echo "am__make_running_with_option: internal error: invalid" \ + "target option '$${target_option-}' specified" >&2; \ + exit 1;; \ + esac; \ + has_opt=no; \ + sane_makeflags=$$MAKEFLAGS; \ + if $(am__is_gnu_make); then \ + sane_makeflags=$$MFLAGS; \ + else \ case $$MAKEFLAGS in \ *\\[\ \ ]*) \ - echo 'am--echo: ; @echo "AM" OK' | $(MAKE) -f - 2>/dev/null \ - | grep '^AM OK$$' >/dev/null || am__dry=yes;; \ - *) \ - for am__flg in $$MAKEFLAGS; do \ - case $$am__flg in \ - *=*|--*) ;; \ - *n*) am__dry=yes; break;; \ - esac; \ - done;; \ + bs=\\; \ + sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \ + | sed "s/$$bs$$bs[$$bs $$bs ]*//g"`;; \ esac; \ - test $$am__dry = yes; \ - } + fi; \ + skip_next=no; \ + strip_trailopt () \ + { \ + flg=`printf '%s\n' "$$flg" | sed "s/$$1.*$$//"`; \ + }; \ + for flg in $$sane_makeflags; do \ + test $$skip_next = yes && { skip_next=no; continue; }; \ + case $$flg in \ + *=*|--*) continue;; \ + -*I) strip_trailopt 'I'; skip_next=yes;; \ + -*I?*) strip_trailopt 'I';; \ + -*O) strip_trailopt 'O'; skip_next=yes;; \ + -*O?*) strip_trailopt 'O';; \ + -*l) strip_trailopt 'l'; skip_next=yes;; \ + -*l?*) strip_trailopt 'l';; \ + -[dEDm]) skip_next=yes;; \ + -[JT]) skip_next=yes;; \ + esac; \ + case $$flg in \ + *$$target_option*) has_opt=yes; break;; \ + esac; \ + done; \ + test $$has_opt = yes +am__make_dryrun = (target_option=n; $(am__make_running_with_option)) +am__make_keepgoing = (target_option=k; $(am__make_running_with_option)) pkgdatadir = $(datadir)/@PACKAGE@ pkgincludedir = $(includedir)/@PACKAGE@ pkglibdir = $(libdir)/@PACKAGE@ @@ -50,11 +78,15 @@ PRE_UNINSTALL = : POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ +@HAVE_MAKEINFO_TRUE@am__append_1 = texinfo +@USE_COLOR_TRUE@am__append_2 = syntax subdir = doc -DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in \ - $(srcdir)/nanorc.sample.in +DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ + $(top_srcdir)/mkinstalldirs $(srcdir)/nanorc.sample.in \ + $(dist_html_DATA) ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ac_define_dir.m4 \ + $(top_srcdir)/m4/ax_check_compile_flag.m4 \ $(top_srcdir)/m4/gettext.m4 $(top_srcdir)/m4/glib-2.0.m4 \ $(top_srcdir)/m4/iconv.m4 $(top_srcdir)/m4/isc-posix.m4 \ $(top_srcdir)/m4/lib-ld.m4 $(top_srcdir)/m4/lib-link.m4 \ @@ -66,25 +98,87 @@ mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = nanorc.sample CONFIG_CLEAN_VPATH_FILES = +AM_V_P = $(am__v_P_@AM_V@) +am__v_P_ = $(am__v_P_@AM_DEFAULT_V@) +am__v_P_0 = false +am__v_P_1 = : +AM_V_GEN = $(am__v_GEN_@AM_V@) +am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@) +am__v_GEN_0 = @echo " GEN " $@; +am__v_GEN_1 = +AM_V_at = $(am__v_at_@AM_V@) +am__v_at_ = $(am__v_at_@AM_DEFAULT_V@) +am__v_at_0 = @ +am__v_at_1 = SOURCES = DIST_SOURCES = -RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ - html-recursive info-recursive install-data-recursive \ - install-dvi-recursive install-exec-recursive \ - install-html-recursive install-info-recursive \ - install-pdf-recursive install-ps-recursive install-recursive \ - installcheck-recursive installdirs-recursive pdf-recursive \ - ps-recursive uninstall-recursive +RECURSIVE_TARGETS = all-recursive check-recursive cscopelist-recursive \ + ctags-recursive dvi-recursive html-recursive info-recursive \ + install-data-recursive install-dvi-recursive \ + install-exec-recursive install-html-recursive \ + install-info-recursive install-pdf-recursive \ + install-ps-recursive install-recursive installcheck-recursive \ + installdirs-recursive pdf-recursive ps-recursive \ + tags-recursive uninstall-recursive am__can_run_installinfo = \ case $$AM_UPDATE_INFO_DIR in \ n|no|NO) false;; \ *) (install-info --version) >/dev/null 2>&1;; \ esac +am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; +am__vpath_adj = case $$p in \ + $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ + *) f=$$p;; \ + esac; +am__strip_dir = f=`echo $$p | sed -e 's|^.*/||'`; +am__install_max = 40 +am__nobase_strip_setup = \ + srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*|]/\\\\&/g'` +am__nobase_strip = \ + for p in $$list; do echo "$$p"; done | sed -e "s|$$srcdirstrip/||" +am__nobase_list = $(am__nobase_strip_setup); \ + for p in $$list; do echo "$$p $$p"; done | \ + sed "s| $$srcdirstrip/| |;"' / .*\//!s/ .*/ ./; s,\( .*\)/[^/]*$$,\1,' | \ + $(AWK) 'BEGIN { files["."] = "" } { files[$$2] = files[$$2] " " $$1; \ + if (++n[$$2] == $(am__install_max)) \ + { print $$2, files[$$2]; n[$$2] = 0; files[$$2] = "" } } \ + END { for (dir in files) print dir, files[dir] }' +am__base_list = \ + sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \ + sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g' +am__uninstall_files_from_dir = { \ + test -z "$$files" \ + || { test ! -d "$$dir" && test ! -f "$$dir" && test ! -r "$$dir"; } \ + || { echo " ( cd '$$dir' && rm -f" $$files ")"; \ + $(am__cd) "$$dir" && rm -f $$files; }; \ + } +am__installdirs = "$(DESTDIR)$(htmldir)" +DATA = $(dist_html_DATA) RECURSIVE_CLEAN_TARGETS = mostlyclean-recursive clean-recursive \ distclean-recursive maintainer-clean-recursive -AM_RECURSIVE_TARGETS = $(RECURSIVE_TARGETS:-recursive=) \ - $(RECURSIVE_CLEAN_TARGETS:-recursive=) tags TAGS ctags CTAGS \ +am__recursive_targets = \ + $(RECURSIVE_TARGETS) \ + $(RECURSIVE_CLEAN_TARGETS) \ + $(am__extra_recursive_targets) +AM_RECURSIVE_TARGETS = $(am__recursive_targets:-recursive=) TAGS CTAGS \ distdir +am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +# Read a list of newline-separated strings from the standard input, +# and print each of them once, without duplicates. Input order is +# *not* preserved. +am__uniquify_input = $(AWK) '\ + BEGIN { nonempty = 0; } \ + { items[$$0] = 1; nonempty = 1; } \ + END { if (nonempty) { for (i in items) print i; }; } \ +' +# Make sure the list of sources is unique. This is necessary because, +# e.g., the same source file might be shared among _SOURCES variables +# for different programs/libraries. +am__define_uniq_tagged_files = \ + list='$(am__tagged_files)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | $(am__uniquify_input)` ETAGS = etags CTAGS = ctags DIST_SUBDIRS = man texinfo syntax @@ -116,6 +210,7 @@ am__relativize = \ reldir="$$dir2" ACLOCAL = @ACLOCAL@ AMTAR = @AMTAR@ +AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ @@ -161,7 +256,11 @@ MKDIR_P = @MKDIR_P@ MKINSTALLDIRS = @MKINSTALLDIRS@ MSGFMT = @MSGFMT@ MSGMERGE = @MSGMERGE@ +NCURSESW_CFLAGS = @NCURSESW_CFLAGS@ NCURSESW_CONFIG = @NCURSESW_CONFIG@ +NCURSESW_LIBS = @NCURSESW_LIBS@ +NCURSES_CFLAGS = @NCURSES_CFLAGS@ +NCURSES_LIBS = @NCURSES_LIBS@ OBJEXT = @OBJEXT@ PACKAGE = @PACKAGE@ PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ @@ -173,6 +272,8 @@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ PKGDATADIR = @PKGDATADIR@ PKG_CONFIG = @PKG_CONFIG@ +PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@ +PKG_CONFIG_PATH = @PKG_CONFIG_PATH@ POSUB = @POSUB@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ @@ -202,6 +303,7 @@ datarootdir = @datarootdir@ docdir = @docdir@ dvidir = @dvidir@ exec_prefix = @exec_prefix@ +haveit = @haveit@ host = @host@ host_alias = @host_alias@ host_cpu = @host_cpu@ @@ -230,9 +332,8 @@ target_alias = @target_alias@ top_build_prefix = @top_build_prefix@ top_builddir = @top_builddir@ top_srcdir = @top_srcdir@ -@USE_COLOR_FALSE@SUBDIRS = man texinfo -@USE_COLOR_TRUE@SUBDIRS = man syntax texinfo -EXTRA_DIST = faq.html +SUBDIRS = man $(am__append_1) $(am__append_2) +dist_html_DATA = faq.html all: all-recursive .SUFFIXES: @@ -268,24 +369,48 @@ $(ACLOCAL_M4): $(am__aclocal_m4_deps) $(am__aclocal_m4_deps): nanorc.sample: $(top_builddir)/config.status $(srcdir)/nanorc.sample.in cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ +install-dist_htmlDATA: $(dist_html_DATA) + @$(NORMAL_INSTALL) + @list='$(dist_html_DATA)'; test -n "$(htmldir)" || list=; \ + if test -n "$$list"; then \ + echo " $(MKDIR_P) '$(DESTDIR)$(htmldir)'"; \ + $(MKDIR_P) "$(DESTDIR)$(htmldir)" || exit 1; \ + fi; \ + for p in $$list; do \ + if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ + echo "$$d$$p"; \ + done | $(am__base_list) | \ + while read files; do \ + echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(htmldir)'"; \ + $(INSTALL_DATA) $$files "$(DESTDIR)$(htmldir)" || exit $$?; \ + done + +uninstall-dist_htmlDATA: + @$(NORMAL_UNINSTALL) + @list='$(dist_html_DATA)'; test -n "$(htmldir)" || list=; \ + files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \ + dir='$(DESTDIR)$(htmldir)'; $(am__uninstall_files_from_dir) # This directory's subdirectories are mostly independent; you can cd -# into them and run `make' without going through this Makefile. -# To change the values of `make' variables: instead of editing Makefiles, -# (1) if the variable is set in `config.status', edit `config.status' -# (which will cause the Makefiles to be regenerated when you run `make'); -# (2) otherwise, pass the desired values on the `make' command line. -$(RECURSIVE_TARGETS): - @fail= failcom='exit 1'; \ - for f in x $$MAKEFLAGS; do \ - case $$f in \ - *=* | --[!k]*);; \ - *k*) failcom='fail=yes';; \ - esac; \ - done; \ +# into them and run 'make' without going through this Makefile. +# To change the values of 'make' variables: instead of editing Makefiles, +# (1) if the variable is set in 'config.status', edit 'config.status' +# (which will cause the Makefiles to be regenerated when you run 'make'); +# (2) otherwise, pass the desired values on the 'make' command line. +$(am__recursive_targets): + @fail=; \ + if $(am__make_keepgoing); then \ + failcom='fail=yes'; \ + else \ + failcom='exit 1'; \ + fi; \ dot_seen=no; \ target=`echo $@ | sed s/-recursive//`; \ - list='$(SUBDIRS)'; for subdir in $$list; do \ + case "$@" in \ + distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ + *) list='$(SUBDIRS)' ;; \ + esac; \ + for subdir in $$list; do \ echo "Making $$target in $$subdir"; \ if test "$$subdir" = "."; then \ dot_seen=yes; \ @@ -300,57 +425,12 @@ $(RECURSIVE_TARGETS): $(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \ fi; test -z "$$fail" -$(RECURSIVE_CLEAN_TARGETS): - @fail= failcom='exit 1'; \ - for f in x $$MAKEFLAGS; do \ - case $$f in \ - *=* | --[!k]*);; \ - *k*) failcom='fail=yes';; \ - esac; \ - done; \ - dot_seen=no; \ - case "$@" in \ - distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ - *) list='$(SUBDIRS)' ;; \ - esac; \ - rev=''; for subdir in $$list; do \ - if test "$$subdir" = "."; then :; else \ - rev="$$subdir $$rev"; \ - fi; \ - done; \ - rev="$$rev ."; \ - target=`echo $@ | sed s/-recursive//`; \ - for subdir in $$rev; do \ - echo "Making $$target in $$subdir"; \ - if test "$$subdir" = "."; then \ - local_target="$$target-am"; \ - else \ - local_target="$$target"; \ - fi; \ - ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ - || eval $$failcom; \ - done && test -z "$$fail" -tags-recursive: - list='$(SUBDIRS)'; for subdir in $$list; do \ - test "$$subdir" = . || ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \ - done -ctags-recursive: - list='$(SUBDIRS)'; for subdir in $$list; do \ - test "$$subdir" = . || ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \ - done +ID: $(am__tagged_files) + $(am__define_uniq_tagged_files); mkid -fID $$unique +tags: tags-recursive +TAGS: tags -ID: $(HEADERS) $(SOURCES) $(LISP) $(TAGS_FILES) - list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ - unique=`for i in $$list; do \ - if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ - done | \ - $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ - END { if (nonempty) { for (i in files) print i; }; }'`; \ - mkid -fID $$unique -tags: TAGS - -TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ - $(TAGS_FILES) $(LISP) +tags-am: $(TAGS_DEPENDENCIES) $(am__tagged_files) set x; \ here=`pwd`; \ if ($(ETAGS) --etags-include --version) >/dev/null 2>&1; then \ @@ -366,12 +446,7 @@ TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ set "$$@" "$$include_option=$$here/$$subdir/TAGS"; \ fi; \ done; \ - list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ - unique=`for i in $$list; do \ - if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ - done | \ - $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ - END { if (nonempty) { for (i in files) print i; }; }'`; \ + $(am__define_uniq_tagged_files); \ shift; \ if test -z "$(ETAGS_ARGS)$$*$$unique"; then :; else \ test -n "$$unique" || unique=$$empty_fix; \ @@ -383,15 +458,11 @@ TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ $$unique; \ fi; \ fi -ctags: CTAGS -CTAGS: ctags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ - $(TAGS_FILES) $(LISP) - list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ - unique=`for i in $$list; do \ - if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ - done | \ - $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ - END { if (nonempty) { for (i in files) print i; }; }'`; \ +ctags: ctags-recursive + +CTAGS: ctags +ctags-am: $(TAGS_DEPENDENCIES) $(am__tagged_files) + $(am__define_uniq_tagged_files); \ test -z "$(CTAGS_ARGS)$$unique" \ || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \ $$unique @@ -400,6 +471,21 @@ GTAGS: here=`$(am__cd) $(top_builddir) && pwd` \ && $(am__cd) $(top_srcdir) \ && gtags -i $(GTAGS_ARGS) "$$here" +cscopelist: cscopelist-recursive + +cscopelist-am: $(am__tagged_files) + list='$(am__tagged_files)'; \ + case "$(srcdir)" in \ + [\\/]* | ?:[\\/]*) sdir="$(srcdir)" ;; \ + *) sdir=$(subdir)/$(srcdir) ;; \ + esac; \ + for i in $$list; do \ + if test -f "$$i"; then \ + echo "$(subdir)/$$i"; \ + else \ + echo "$$sdir/$$i"; \ + fi; \ + done >> $(top_builddir)/cscope.files distclean-tags: -rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags @@ -461,9 +547,12 @@ distdir: $(DISTFILES) done check-am: all-am check: check-recursive -all-am: Makefile +all-am: Makefile $(DATA) installdirs: installdirs-recursive installdirs-am: + for dir in "$(DESTDIR)$(htmldir)"; do \ + test -z "$$dir" || $(MKDIR_P) "$$dir"; \ + done install: install-recursive install-exec: install-exec-recursive install-data: install-data-recursive @@ -514,7 +603,7 @@ info: info-recursive info-am: -install-data-am: +install-data-am: install-dist_htmlDATA install-dvi: install-dvi-recursive @@ -558,23 +647,22 @@ ps: ps-recursive ps-am: -uninstall-am: +uninstall-am: uninstall-dist_htmlDATA -.MAKE: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) ctags-recursive \ - install-am install-strip tags-recursive +.MAKE: $(am__recursive_targets) install-am install-strip -.PHONY: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) CTAGS GTAGS \ - all all-am check check-am clean clean-generic ctags \ - ctags-recursive distclean distclean-generic distclean-tags \ - distdir dvi dvi-am html html-am info info-am install \ - install-am install-data install-data-am install-dvi \ +.PHONY: $(am__recursive_targets) CTAGS GTAGS TAGS all all-am check \ + check-am clean clean-generic cscopelist-am ctags ctags-am \ + distclean distclean-generic distclean-tags distdir dvi dvi-am \ + html html-am info info-am install install-am install-data \ + install-data-am install-dist_htmlDATA install-dvi \ install-dvi-am install-exec install-exec-am install-html \ install-html-am install-info install-info-am install-man \ install-pdf install-pdf-am install-ps install-ps-am \ install-strip installcheck installcheck-am installdirs \ installdirs-am maintainer-clean maintainer-clean-generic \ mostlyclean mostlyclean-generic pdf pdf-am ps ps-am tags \ - tags-recursive uninstall uninstall-am + tags-am uninstall uninstall-am uninstall-dist_htmlDATA # Tell versions [3.59,3.63) of GNU make to not export all variables. diff --git a/doc/faq.html b/doc/faq.html index 2d80be2f..d24a895b 100644 --- a/doc/faq.html +++ b/doc/faq.html @@ -24,7 +24,6 @@ <blockquote><p><a href="#3.1">3.1. How do I install the RPM or DEB package?</a><br> <a href="#3.2">3.2. Compiling from source: WHAT THE HECK DO I DO NOW?</a><br> <a href="#3.3">3.3. Why does everything go into /usr/local?</a><br> - <a href="#3.4">3.4. I get errors about 'bindtextdomain','gettext', and/or 'gettextdomain'. What can I do about it?</a><br> <a href="#3.5">3.5. nano should automatically run strip on the binary when installing it!</a><br> <a href="#3.6">3.6. How can I make the executable smaller? This is too bloated!</a><br> <a href="#3.7">3.7. Tell me more about this multibuffer stuff!</a><br> @@ -47,7 +46,7 @@ <a href="#4.12">4.12. I've compiled nano with color support, but I don't see any color when I run it!</a><br> <a href="#4.13">4.13. How do I select text for or paste text from the clipboard in an X terminal when I'm running nano in one and nano's mouse support is turned on?</a><br> <a href="#4.14">4.14. When I paste text into a document, each line gets indented further than the last. Why does nano do this, and how can I avoid it?</a><br> - <a href="#4.15">4.15. On startup I get a message that says "Detected a legacy nano history file". Now other nano versionc can't find my search history!</a></p></blockquote> + <a href="#4.15">4.15. On startup I get a message that says "Detected a legacy nano history file". Now older nano versions can't find my search history!</a></p></blockquote> <h2><a href="#5">5. Internationalization</a></h2> <blockquote><p><a href="#5.1">5.1. There's no translation for my language!</a><br> <a href="#5.2">5.2. I don't like the translation for <x> in my language. How can I fix it?</a><br> @@ -85,7 +84,7 @@ <h2><a name="1.5"></a>1.5. Why the name change from TIP?</h2> <blockquote><p>On January 10, 2000, TIP was officially renamed to nano because of a namespace conflict with another program called 'tip'. The original 'tip' program "establishes a full duplex terminal connection to a remote host", and was included with many older Unix systems (and newer ones like Solaris). The conflict was not noticed at first because there is no 'tip' utility included with most GNU/Linux distributions (where nano was developed).</p></blockquote> <h2><a name="1.6"></a>1.6. What is the current version of nano?</h2> -<blockquote><p>The current version of nano *should* be 2.2.0. Of course, you should always check the nano homepage to see what the latest and greatest version is.</p></blockquote> +<blockquote><p>The current stable version of nano *should* be 2.2.6. Of course, you should always check the nano homepage to see what the latest and greatest version is.</p></blockquote> <h2><a name="1.7"></a>1.7. I want to read the man page without having to download the program!</h2> <blockquote><p>Jeez, demanding, aren't we? Okay, look <a href="http://www.nano-editor.org/dist/v2.2/nano.1.html">here</a>.</p></blockquote> <hr width="100%"> @@ -94,7 +93,6 @@ <blockquote><p>The nano distribution can be downloaded at the following fine web and ftp sites:</p> <ul> <li><a href="http://www.nano-editor.org/dist/">http://www.nano-editor.org/dist/</a></li> - <li><a href="http://www.ewtoo.org/~astyanax/nano/dist/">http://www.ewtoo.org/~astyanax/nano/dist/</a></li> <li><a href="ftp://ftp.gnu.org/pub/gnu/nano/">ftp://ftp.gnu.org/pub/gnu/nano/</a></li> </ul> </blockquote> @@ -102,18 +100,17 @@ <blockquote> <ul> <li><a href="http://www.nano-editor.org/dist/v2.2/RPMS/">http://www.nano-editor.org/dist/v2.2/RPMS/</a></li> - <li><a href="http://www.ewtoo.org/~astyanax/nano/dist/v2.2/RPMS/">http://www.ewtoo.org/~astyanax/nano/dist/v2.2/RPMS/</a></li> </ul> </blockquote> <h2><a name="2.3"></a>2.3. Debian (.deb) packages.</h2> <blockquote><p>Debian users can check out the current nano packages for:</p> <ul> - <li><a href="http://packages.debian.org/stable/editors/nano.html">stable</a></li> - <li><a href="http://packages.debian.org/testing/editors/nano.html">testing</a></li> - <li><a href="http://packages.debian.org/unstable/editors/nano.html">unstable</a></li> + <li><a href="http://packages.debian.org/stable/editors/nano">stable</a></li> + <li><a href="http://packages.debian.org/testing/editors/nano">testing</a></li> + <li><a href="http://packages.debian.org/unstable/editors/nano">unstable</a></li> </ul> <p>You can also have a look at the <a href="ftp://ftp.debian.org/debian/pool/main/n/nano/">Package Pool</a> to see all the available binary and source packages.</p> - <p>Note that versions < 0.9.10 are probably not for those wanting to get serious work done, so if you are using Debian 2.2, check that you have updated to 2.2r3, which comes with nano 0.9.23. If you're tracking unstable, you probably have the newest version already.</p></blockquote> +</blockquote> <h2><a name="2.4"></a>2.4. By subversion (for the brave).</h2> <blockquote><p>For the 'bleeding edge' current version of nano, you can use subversion to download the current source code. <b>Note:</b> believe it or not, by downloading code that has not yet stabilized into an official release, there could quite possibly be bugs, in fact the code may not even compile! Anyway, see <a href="http://svn.savannah.gnu.org/viewvc/trunk/nano/README.SVN?root=nano&view=markup">the nano SVN document</a> for info on anonymous SVN access to the nano source.</p></blockquote> <hr width="100%"> @@ -122,10 +119,8 @@ <blockquote><p>It's simple really! As root, type <b>rpm -Uvh nano-x.y.z-1.i386.rpm</b> if you have a RedHat-ish system or <b>dpkg -i nano_x.y.z-1.deb</b> if you have a Debian-ish system, where <b>x.y.z</b> is the release of nano. There are other programs to install packages, and if you wish to use those, knock yourself out.</p></blockquote> <h2><a name="3.2"></a>3.2. Compiling from source: WHAT THE HECK DO I DO NOW?</h2> <blockquote><p>Okay, take a deep breath, this really isn't hard. Unpack the nano source with a command like:</p> - <p><b>tar -zxvf nano-x.y.z.tar.gz</b></p> - <p>If you get error messages about the -z option, try this:</p> - <p><b>gzip -dc nano-x.y.z.tar.gz | tar xvf -</b></p> - <p>(again, where x.y.z is the version number in question). Then you need to run configure with any options you might want (if any).</p> + <p><b>tar -xvf nano-x.y.z.tar.gz</b></p> + <p>Then you need to run <b>configure</b> with any options you might want (if any).</p> <p>The average case is this:</p> <p><b>cd nano-x.y.z/</b><br> <b>./configure</b><br> @@ -135,73 +130,67 @@ <blockquote><p>Well, that's what the <b>configure</b> script defaults to. If you wish to change this, simply do this:</p> <p><b>./configure --prefix=/usr</b></p> <p>to put nano into /usr/bin when you run <b>make install</b>.</p></blockquote> -<h2><a name="3.4"></a>3.4. I get errors about 'bindtextdomain', 'gettext', and/or 'gettextdomain'. What can I do about it?</h2> -<blockquote><p>Try doing a <b>./configure --with-included-gettext</b> and see if that solves your problem. You may need to do a <b>make clean; make</b> to get it to work fully.</p></blockquote> <h2><a name="3.5"></a>3.5. nano should automatically run strip on the binary when installing it!</h2> <blockquote><p>Actually, it does, but you have to use <b>make install-strip</b>. The default make install does not, and will not, run strip automatically.</p></blockquote> <h2><a name="3.6"></a>3.6. How can I make the executable smaller? This is too bloated!</h2> <blockquote><p>Actually, there are several parts of the editor that can be disabled. You can pass arguments to the <b>configure</b> script that disable certain features. Here's a brief list:</p> <pre> - <b>--disable-tabcomp</b> Disable tab completion functions - <b>--disable-justify</b> Disable justify/unjustify functions - <b>--disable-speller</b> Disable spell checker functions - <b>--disable-help</b> Disable help functions <b>--disable-browser</b> Disable built-in file browser - <b>--disable-wrapping</b> Disable all wrapping of text (and -w flag) + <b>--disable-color</b> Disable color and syntax highlighting + <b>--disable-extra</b> Disable extra features, currently only an easter egg + <b>--disable-help</b> Disable help functions + <b>--disable-justify</b> Disable justify/unjustify functions <b>--disable-mouse</b> Disable mouse support (and -m flag) - <b>--disable-operatingdir</b> Disable setting of operating directory</pre> - <p>There's also the <b>--enable-tiny</b> option which disables everything above, as well as some larger chunks of the program (like the marker code that you use Control-^ to select with). Also, if you know you aren't going to be using other languages you can use <b>--disable-nls</b> to disable internationalization and save a few K to a few dozen K depending on if you have locale support on your system. And finally there's always good old <b>strip</b> to strip all debugging code and code that exists in libraries on your system.</p> - <p>If, on the other hand, you can't live without bells and whistles, you could try:</p> - <pre> - <b>--enable-extra</b> Enable extra features, currently only easter eggs - <b>--enable-nanorc</b> Enable use of .nanorc files - <b>--enable-color</b> Enable color and syntax highlighting - <b>--enable-multibuffer</b> Enable having multiple file buffers open - <b>--enable-all</b> Enable all of the above features - <b>--disable-wrapping-as-root</b> - Disable text wrapping by default when the user is - root</pre></blockquote> + <b>--disable-multibuffer</b> Disable having multiple file buffers open + <b>--disable-nanorc</b> Disable the use of .nanorc files + <b>--disable-operatingdir</b> Disable setting of operating directory + <b>--disable-speller</b> Disable spell checker functions + <b>--disable-tabcomp</b> Disable tab completion functions + <b>--disable-wrapping</b> Disable all wrapping of text (and -w flag)</pre> + <p>There's also the <b>--enable-tiny</b> option which disables everything above, as well as some larger chunks of the program (like the marker code that you use with Control-^ to select text). Also, if you know you aren't going to be using other languages you can use <b>--disable-nls</b> to disable internationalization and save a few K to a few dozen K depending on if you have locale support on your system. And finally there's always good old <b>strip</b> to strip all debugging code and code that exists in libraries on your system.</p> + <p>With <b>--disable-wrapping-as-root</b> you can disable any hard-wrapping by default when the user is root, useful to prevent accidentally changing long lines in system configuration files.</p> +</blockquote> <h2><a name="3.7"></a>3.7. Tell me more about this multibuffer stuff!</h2> -<blockquote><p>To use multiple file buffers, you must be using nano 1.1.0 or newer, and you must have configured nano with <b>--enable-multibuffer</b> (use nano -V to check). Then when you want to enable inserting a file into its own buffer instead of into the current file, just hit <b>Meta-F</b>, then insert the file as normal with <b>^R</b>. If you always want files to be loaded into their own buffers, use the <b>--multibuffer</b> or <b>-F</b> flag when you invoke nano.</p> +<blockquote><p>To use multiple file buffers, you must be using nano 1.1.0 or newer, and you must not have configured it with <b>--disable-multibuffer</b> nor with <b>--enable-tiny</b> (use <b>nano -V</b> to check the compilation options). Then when you want to insert a file into its own buffer instead of into the current file, just hit <b>Meta-F</b>, then insert the file as normal with <b>^R</b>. If you always want files to be loaded into their own buffers, use the <b>--multibuffer</b> or <b>-F</b> flag when you invoke nano.</p> <p>You can move between the buffers you have open with the <b>Meta-<</b> and <b>Meta-></b> keys, or more easily with <b>Meta-,</b> and <b>Meta-.</b> (clear as mud, right? =-). When you have more than one file buffer open, the ^X shortcut will say "Close", instead of the normal "Exit" when only one buffer is open.</p></blockquote> <h2><a name="3.8"></a>3.8. Tell me more about this verbatim input stuff!</h2> -<blockquote><p>To use verbatim input, you must be using nano 1.3.1 or newer. When you want to insert a literal character into the file you're editing, such as a control character that nano usually treats as a command, first press <b>Meta-V</b>. (If you're not at a prompt, you'll get the message "Verbatim Input".) Then press the key(s) that generate the character you want.</p> - <p>Alternatively, if you've enabled Unicode support (see section <a href="#5.3">5.3</a>), you can press <b>Meta-V</b> and then type a six-digit hexadecimal code from 000000 to 10FFFF (case-insensitive), and the character with the corresponding value will be inserted instead. The prompt will change to "Unicode Input" when you do this.</p></blockquote> +<blockquote><p>To use verbatim input, you must be using nano 1.3.1 or newer. When you want to insert a literal character into the file you're editing, such as a control character that nano usually treats as a command, first press <b>Meta-V</b> (if you're not at a prompt, you'll get the message "Verbatim Input"), then press the key(s) that generate the character you want.</p> + <p>Alternatively, if you've enabled Unicode support (see section <a href="#5.3">5.3</a>), you can press <b>Meta-V</b> and then type a six-digit hexadecimal code (from 000000 to 10FFFF, case-insensitive), and the character with the corresponding value will be inserted instead. The prompt will change to "Unicode Input" when you do this.</p></blockquote> <h2><a name="3.9"></a>3.9. How do I make a .nanorc file that nano will read when I start it?</h2> -<blockquote><p>It's not hard at all! But, your version of nano must have been compiled with <b>--enable-nanorc</b>, and again must be version 1.1.12 or newer (use nano -V to check your version and compiled features). Then simply copy the <b>nanorc.sample</b> that came with the nano source or your nano package (most likely in /usr/doc/nano) to .nanorc in your home directory. If you didn't get one, the syntax is simple. Flags are turned on and off by using the word <b>set</b> and the getopt_long flag for the feature, for example "set nowrap" or "set suspend".</p></blockquote> +<blockquote><p>It's not hard at all! But, your version of nano must not have been compiled with <b>--disable-nanorc</b>, and must be version 1.1.12 or newer (use nano -V to check your version and compiled features). Then simply copy the <b>nanorc.sample</b> that came with the nano source or your nano package (most likely in /usr/doc/nano) to .nanorc in your home directory. If you didn't get one, the syntax is simple. Flags are turned on and off by using the word <b>set</b> and the getopt_long flag for the feature, for example "set nowrap" or "set suspend".</p></blockquote> <h2><a name="3.9.1"></a>3.9. How about in Win32?</h2> <blockquote><p>If you're using the official nano .zip file and have extracted all the files, you should take the file nano.rc and place it somewhere on your Win32 system (for example if you have write permission to do so, at the top of C:\). Then you must create an Environment variable called HOME which points to the directory where you put nano.rc. In Windows XP, you can get to Environment variables by right-clicking "My Computer" either on the desktop or in the Start Menu, and selecting Properties. This should bring up the System Properties panel. Then click the Advanced Tab, and there should be a button called Environment Variables. Click that to bring up the Environment Variables section. Now, under User Variables you should be able to click the New button, and make a new Variables Name called HOME, with the Variable Value of whatever path you copied nano.rc into (just the directory name; don't add nano.rc onto the end).</p> -<p>We're still working on documentatino for enabling synax highlighting on Win32; please bear with us</p> -<p>Note that the nano.rc file must remain Unix formated in order for nano to unerstand it. In other words, you should use probably only use nano to edit its config file. Other programs like Wordpad and Notepad will either convert the file to DOS format when saving, and the latter does not even properly read Unix-formatted files to begin with.</p></blockquote> +<p>We're still working on documentation for enabling synax highlighting on Win32; please bear with us.</p> +<p>Note that the nano.rc file must remain Unix-formated in order for nano to understand it. In other words, you should probably use only nano to edit its config file. Other programs like Wordpad and Notepad will convert the file to DOS format when saving, and the latter does not even properly read Unix-formatted files to begin with.</p></blockquote> <hr width="100%"> <h1><a name="4"></a>4. Running</h1> <h2><a name="4.1"></a>4.1. How do I open a file with a name beginning with '+' from the command line?</h2> -<blockquote><p>If a command line option that begins with '+' is followed by another option, the former is always treated as a starting line and column number and the latter is always treated as a filename. If a command line option that begins with '+' isn't followed by another option, it's always treated as a filename. Examples:</p> +<blockquote><p>If a command-line option that begins with '+' is followed by another option, the former is always treated as a starting line and column number, and the latter is always treated as a filename. If a command-line option that begins with '+' isn't followed by another option, it's always treated as a filename. Examples:</p> <p>To open '+filename.txt' starting on line 1: <b>nano +filename.txt</b><br> To open '+filename.txt' starting on line 10: <b>nano +10 +filename.txt</b><br> To open '+filename.txt' starting on line 1, column 20: <b>nano +,20 +filename.txt</b><br> To open '+filename.txt' starting on line 10, column 20: <b>nano +10,20 +filename.txt</b><br> - To open '+filename.txt' starting on line 1 and 'filename.txt' starting on line 10 (if nano has been compiled with multibuffer support): <b>nano +1 +filename.txt +20 filename.txt</b></p></blockquote> + To open '+filename.txt' starting on line 1 and 'filename.txt' starting on line 40 (if nano has been compiled with multibuffer support): <b>nano +1 +filename.txt +40 filename.txt</b></p></blockquote> <h2><a name="4.2"></a>4.2. Ack! My Backspace/Delete/Enter/Meta/double bucky key doesn't seem to work! What can I do?</h2> <blockquote><p>Try setting your $TERM variable to 'vt100'. nano doesn't yet support every term entry under the sun.</p> <p>Bourne shell users (bash and sh): <b>export TERM=vt100</b><br> C Shell users (tcsh and csh): <b>setenv TERM vt100</b></p></blockquote> <h2><a name="4.3"></a>4.3. Ack! My numeric keypad's keys don't work properly when NumLock is off! What can I do?</h2> -<blockquote><p>You can use the <b>-K</b> or <b>--rebindkeypad</b> options on the command line, or add the line <b>set rebindkeypad</b> to your .nanorc. However, nano's mouse support won't work properly if you do any of these things.</p></blockquote> +<blockquote><p>You can use the <b>-K</b> or <b>--rebindkeypad</b> option on the command line, or add the line <b>set rebindkeypad</b> to your .nanorc. However, nano's mouse support won't work properly if you do any of these things.</p></blockquote> <h2><a name="4.4"></a>4.4. Ack! When I hold down a Meta key combination for a while, the character of the held key gets inserted now and then. What gives?</h2> <blockquote><p>This is a bug in the terminal, not in nano. When a key is repeating faster than nano can process it, the keyboard buffer becomes full and starts dropping incoming keystrokes. Unfortunately, it doesn't just drop whole keystrokes; it can also drop parts of multibyte key combinations, resulting in nano's receiving a wrong key.</p></blockquote> <h2><a name="4.5"></a>4.5. How do I type the F13-F16 keys shown in the help browser? My keyboard only has F1-F12!</h2> <blockquote><p>It depends on the terminal type you're using. On some terminals, such as the FreeBSD console, xterm, konsole, and gnome-terminal, Shift-F1 to Shift-F4 will generate F13 to F16. On other terminals, such as the Linux console, rxvt, and Eterm, Shift-F3 to Shift-F6 will generate F13 to F16.</p></blockquote> <h2><a name="4.6"></a>4.6. nano crashes when I type <insert keystroke here>!</h2> -<blockquote><p>If you aren't trying some bizarre keystroke combination with some bizarre $TERM entry, chances are you have found a bug. You are welcome to submit it to the <a href="mailto:nano-devel@gnu.org">nano-devel</a> list or to <a href="mailto:nano@nano-editor.org">nano@nano-editor.org</a>.</p></blockquote> +<blockquote><p>If you aren't trying some bizarre keystroke combination with some bizarre $TERM entry, chances are you have found a bug. You are welcome to submit it to the <a href="mailto:nano-devel@gnu.org">nano-devel</a> list or in the <a href="https://savannah.gnu.org/bugs/?group=nano">bug database</a> on Savannah.</p></blockquote> <h2><a name="4.7"></a>4.7. nano crashes when I resize my window. How can I fix that?</h2> -<blockquote><p>Older versions of nano had this problem, please upgrade to a newer version (at least 0.9.9 would be great, 0.9.12 is recommended).</p></blockquote> +<blockquote><p>Older versions of nano had this problem, please upgrade to a newer version (at least 0.9.9, but 2.2.6 is recommended).</p></blockquote> <h2><a name="4.8"></a>4.8. [version 1.3.12 and later] I'm using glibc 2.2.3, and nano crashes when I use color support or do regular expression searches. How can I fix that?</h2> <blockquote><p>It's a bug in glibc 2.2.3. You should upgrade to at least glibc 2.2.4.</p></blockquote> <h2><a name="4.9"></a>4.9. [version 1.1.12 and earlier] Why does nano show ^\ in the shortcut list instead of ^J?</h2> -<blockquote><p>The help (^G) and justify (^J) function were among the last to be written. To show the improvements that nano had over Pico (go to line # and replace), ^_ and ^\ were put on the shortcut list. Later, ^G came back in place of ^_ as it proved to be very valuable for new Unix users. If you use the <b>-p</b> option to nano (or hit Meta-P) you will get the same shortcuts at the bottom as Pico.</p></blockquote> +<blockquote><p>The help (^G) and justify (^J) functions were among the last to be written. To show the improvements that nano had over Pico (go to line number, and replace), ^_ and ^\ were put on the shortcut list. Later, ^G came back in place of ^_ as it proved to be very valuable for new Unix users.</p></blockquote> <h2><a name="4.10a"></a>4.10a. [version 1.1.12 and earlier] When I type in a search string, the string I last searched for is already in front of my cursor! What happened?!</h2> -<blockquote><p>In nano version 0.9.20, the default is to have a completely consistent user interface across all user input functions. This means that regardless of whether you're being asked for a filename to insert or write, or a string to search for, the previous value is already inserted before the cursor. If you prefer the old behavior, use the Pico emulation mode (-p or --pico) or just hit Meta-P while in nano (see the ^G help text for more details).</p></blockquote> +<blockquote><p>Since nano version 0.9.20, the default was to have a completely consistent user interface across all user input functions. This means that regardless of whether you're being asked for a filename to insert or write, or a string to search for, the previous value is already inserted before the cursor.</p></blockquote> <h2><a name="4.10b"></a>4.10b. [version 1.1.99pre1 and later] Hey, the search string behavior has reverted, it's now like Pico, what happened to the consistency?</h2> <blockquote><p>It was decided that consistency was nice, but people are used to Pico's inconsistent behavior. Also, in version 1.1.99pre1, search and replace history was introduced. If you wish to edit your previous search/replace entry (or any previous entry), you can do so by hitting the up arrow to cycle through your history. This method allows the best of both worlds: You don't need to erase the previous string if you want to enter a new one, but you can with one keystroke recall previous entries for editing. Therefore there is now no "Pico mode", nano is and has always been a Pico <b>clone</b>, and clones by default should be compatible.</p></blockquote> <h2><a name="4.11"></a>4.11. How do I make nano my default editor (in Pine, mutt, etc.)?</h2> @@ -209,7 +198,7 @@ <p><b>export EDITOR=/usr/local/bin/nano</b></p> <p>or, if you use tcsh, put this in your <b>.cshrc</b> file:</p> <p><b>setenv EDITOR /usr/local/bin/nano</b></p> - <p>Change /usr/local/bin/nano to wherever nano is installed on your system. Type "which nano" to find out. This will not take effect until the next time you login. So log out and back in again.</p> + <p>Change /usr/local/bin/nano to wherever nano is installed on your system. Type "which nano" to find out. This will not take effect until the next time you log in. So log out and back in again.</p> <p>Then, on top of that, if you use Pine, you must go into setup (type <b>S</b> at the main menu), and then configure (type <b>C</b>). Hit Enter on the lines that say:</p> <p><b>[ ] enable-alternate-editor-cmd</b><br> <b>[ ] enable-alternate-editor-implicitly</b></p> @@ -218,24 +207,24 @@ <p><b>my_hdr X-Composer: nano x.y.z</b></p> <p>Again, replace x.y.z with the version of nano you use.</p></blockquote> <h2><a name="4.12"></a>4.12. I've compiled nano with color support, but I don't see any color when I run it!</h2> -<blockquote><p>If you want nano to actually use color, you have to specify the color configurations you want it to use in your .nanorc. Some example configurations are in the <b>nanorc.sample</b> that comes with the nano source or your nano package. See Section <a href="#3.9">3.9</a>.</p></blockquote> +<blockquote><p>If you want nano to actually use color, you have to specify the color configurations you want it to use in your .nanorc. Several example configurations are in the <b>doc/syntax</b> subdirectory of the nano source, which are normally installed to <b>/usr/local/share/nano</b>. To enable all of them, uncomment the line <b># include "/usr/local/share/nano/*.nanorc"</b> in your nanorc. See also section <a href="#3.9">3.9</a>.</p></blockquote> <h2><a name="4.13"></a>4.13. How do I select text for or paste text from the clipboard in an X terminal when I'm running nano in one and nano's mouse support is turned on?</h2> <blockquote><p>Try holding down the Shift key and selecting or pasting the text as you normally would.</p></blockquote> <h2><a name="4.14"></a>4.14. When I paste text into a document, each line gets indented further than the last. Why does nano do this, and how can I avoid it?</h2> <blockquote><p>You have the autoindent feature turned on. Hit Meta-I to turn it off, paste your text, and then hit Meta-I again to turn it back on.</p></blockquote> -<h2><a name="4.15"></a>4.15. On startup I get a message that says "Detected a legacy nano history file". Now other nano versionc can't find my search history!</h2> -<blockquote><p>In nano 2.3.0, cursor position history was introduced, and both files now reside under a .nano directory in your home. Nano was trying to move this file into the new location so it could continue to use it. This means that if you try and use an earlier version of nano, it will be unable to see your previous search history. To fix this, run the following commands:<br> +<h2><a name="4.15"></a>4.15. On startup I get a message that says "Detected a legacy nano history file". Now older nano versions can't find my search history!</h2> +<blockquote><p>In nano 2.3.0, cursor-position history was introduced, and both history files now reside under a .nano directory in your home. nano was trying to move this file into the new location so it could continue to use it. This means that if you try and use an earlier version of nano, it will be unable to see your current search history. To fix this, run the following commands:<br> mv ~/.nano/search_history ~/.nano_history<br> ln -sf ~/.nano_history ~/.nano/search_history<br> </p></blockquote> <hr width="100%"> <h1><a name="5"></a>5. Internationalization</h1> <h2><a name="5.1"></a>5.1. There's no translation for my language!</h2> -<blockquote><p>On June of 2001, GNU nano entered the <a href="http://translationproject.org/html/welcome.html">Free Translation Project</a> and since then, translations should be managed from there.</p> - <p>If there isn't a translation for your language, you could ask <a href="http://translationproject.org/team/">your language team</a> to translate nano, or better still, join your team and do it yourself. Joining a team is easy. You just need to ask the <a href="mailto:coordinator@translationproject.org">TP coordinator</a> to add you to your team, and send a <a href="http://translationproject.org/disclaim.txt">translation disclaimer to the FSF</a> (this is necessary as nano is an official GNU package, but it does <b>not</b> mean that you transfer the rights of your work to the FSF, it's just so the FSF can legally manage them).</p> - <p>In any case, translating nano is very easy. Just grab the <b>nano.pot</b> file from the latest and greatest nano distribution (it's in the <b>po/</b> directory) and translate each line into your native language on the <b>msgstr</b> line. When you're done, you should send it to the TP's central po repository.</p></blockquote> +<blockquote><p>On June of 2001, GNU nano entered the <a href="http://translationproject.org/html/welcome.html">Translation Project</a> and since then, translations should be managed from there.</p> + <p>If there isn't a translation for your language, you could ask <a href="http://translationproject.org/team/">your language team</a> to translate nano, or better still, join that team and do it yourself. Joining a team is easy. You just need to ask the team leader to add you, and then send a <a href="http://translationproject.org/disclaim.txt">translation disclaimer to the FSF</a> (this is necessary as nano is an official GNU package, but it does <b>not</b> mean that you transfer the rights of your work to the FSF, it's just so the FSF can legally manage them).</p> + <p>In any case, translating nano is very easy. Just grab the latest <b>nano.pot</b> file listed on <a href="http://translationproject.org/domain/nano.html">nano's page</a> at the TP, and translate each <b>msgid</b> line into your native language on the <b>msgstr</b> line. When you're done, you should send it to the TP's central po repository.</p></blockquote> <h2><a name="5.2"></a>5.2. I don't like the translation for <x> in my language. How can I fix it?</h2> -<blockquote><p>The best way would probably be to e-mail the person listed in the <code>Last-Translator:</code> field in the <b><your_language>.po</b> file with your suggested corrections and they can make the changes reach the nano-devel list.</p></blockquote> +<blockquote><p>The best way would probably be to send an e-mail to the team's mailing listed mentione in the <code>Language-Team:</code> field in the <b><your_language>.po</b> file with your suggested corrections, and then they can make the changes reach the nano-devel list.</p></blockquote> <h2><a name="5.3"></a>5.3. What is the status of Unicode support?</h2> <blockquote><p>In version 1.3.12 or later, Unicode should be usable. With your terminal, locale (LC_ALL and similar environment variables), and encoding configured to properly support UTF-8, you should be able to enter and save Unicode text.</p></blockquote> <hr width="100%"> @@ -252,22 +241,23 @@ Of course, due to the license change you can now use the <A HREF="http://www.was <hr width="100%"> <h1><a name="7"></a>7. Miscellaneous</h1> <h2><a name="7.1"></a>7.1. nano-related mailing lists.</h2> -<blockquote><p>There are three mailing lists for nano hosted at <a href="http://savannah.gnu.org/">Savannah</a>, info-nano, help-nano and nano-devel. info-nano is a very low traffic list where new versions of nano are announced (surprise!). help-nano is for getting help with the editor without needing to hear all of the development issues surrounding it. nano-devel is a normally low, sometimes high traffic list for discussing the present and future development of nano. Here are links to where you can sign up for a given list:</p> +<blockquote><p>There are three mailing lists for nano hosted at <a href="http://savannah.gnu.org/">Savannah</a>: info-nano, help-nano and nano-devel. info-nano is a very low traffic list where new versions of nano are announced (surprise!). help-nano is for getting help with the editor without needing to hear all of the development issues surrounding it. nano-devel is a normally low, sometimes high traffic list for discussing the present and future development of nano. Here are links to where you can sign up for a given list:</p> <p>info-nano - <a href="http://mail.gnu.org/mailman/listinfo/info-nano/">http://mail.gnu.org/mailman/listinfo/info-nano/</a><br> help-nano - <a href="http://mail.gnu.org/mailman/listinfo/help-nano/">http://mail.gnu.org/mailman/listinfo/help-nano/</a><br> nano-devel - <a href="http://mail.gnu.org/mailman/listinfo/nano-devel/">http://mail.gnu.org/mailman/listinfo/nano-devel/</a></p></blockquote> <h2><a name="7.2"></a>7.2. I want to send the development team a big load of cash (or just a thank you).</h2> -<blockquote><p>That's fine. Send it <a href="mailto:nano-devel@gnu.org">our way</a>! Better yet, fix a <a href="http://www.nano-editor.org/dist/v2.2/BUGS">bug</a> in the program or implement a <a href="http://www.nano-editor.org/dist/v2.2/TODO">cool feature</a> and send us that instead (though cash is fine too).</p></blockquote> +<blockquote><p>That's fine. Send it <a href="mailto:nano-devel@gnu.org">our way</a>! Better yet, fix a <a href="https://savannah.gnu.org/bugs/?group=nano">bug</a> in the program or implement a <a href="http://www.nano-editor.org/dist/v2.3/TODO">cool feature</a> and send us that instead (though cash is fine too).</p></blockquote> <h2><a name="7.3"></a>7.3. How do I submit a bug report or patch?</h2> <blockquote> -<p>The best place to submit bugs is to the <A HREF="https://savannah.gnu.org/bugs/?group=nano">Savannah bug tracker</A> as you can check whether the bug you are submitting has already been submitted. +<p>The best place to submit bugs is to the <a href="https://savannah.gnu.org/bugs/?group=nano">Savannah bug tracker</a> as you can check whether the bug you are submitting has already been submitted. <p>Please submit patches for nano via the <a href="https://savannah.gnu.org/patch/?group=nano">Savannah project's patch manager</a> for the nano project.</p></blockquote> <h2><a name="7.4"></a>7.4. How do I join the development team?</h2> -<blockquote><p>The easiest way is to consistently send in good patches that add some needed functionality, fix a bug or two and/or make the program more optimized/efficient. Then ask nicely and you will probably be added to the Savannah development list and be given SVN write access after awhile. There is a lot of responsibility that goes along with being a team member, so don't think it's just something to add to your resume.</p></blockquote> +<blockquote><p>The easiest way is to consistently send in good patches that add some needed functionality, fix a bug or two, and/or make the program more optimized/efficient. Then ask nicely and you will probably be added to the Savannah development list and be given SVN write access after a while. There is a lot of responsibility that goes along with being a team member, so don't think it's just something to add to your resume.</p></blockquote> <h2><a name="7.5"></a>7.5. Can I have write access to the subversion tree?</h2> <blockquote><p>Re-read Section <a href="#7.4">7.4</a> and you should know the answer.</p></blockquote> <h2><a name="8"></a>8. ChangeLog</h2> -<blockquote><p>2009/11/30 - Update various bits for nano 2.2.x. (DLR)<br> +<blockquote><p>2014/04/24 - A bunch of small fixes and updates. (Benno)<br> +2009/11/30 - Update various bits for nano 2.2.x. (DLR)<br> 2009/11/18 - Typo fix. (j.mader@gmail.com)<br> 2008/03/16 - Update docs to refer to subversion instead of CVS, add more words about Alpine, and refer to Savannah for bugs and patches. (chrisa)<br> 2007/12/21 - Update maintainer information. (DLR)<br> @@ -332,6 +322,6 @@ Of course, due to the license change you can now use the <A HREF="http://www.was 2000/11/18 - Previous string display (4.5).<br> 2000/09/27 - Moved addresses to nano-editor.org.<br> 2000/06/31 - Initial framework.</p></blockquote> -<p>$Id: faq.html 4530 2011-02-18 07:30:57Z astyanax $</p> +<p>$Id: faq.html 4814 2014-04-24 20:22:32Z bens $</p> </body> </html> diff --git a/doc/man/Makefile.am b/doc/man/Makefile.am index fbcdce86..f7ad09a9 100644 --- a/doc/man/Makefile.am +++ b/doc/man/Makefile.am @@ -1,27 +1,18 @@ -if USE_NLS -SUBDIRS = fr -else SUBDIRS = +BUILT_SOURCES = + +if USE_NLS +SUBDIRS += fr endif +dist_man_MANS = nano.1 rnano.1 +html_pages = nano.1.html rnano.1.html + if USE_NANORC -man_MANS = nano.1 nanorc.5 rnano.1 -if GROFF_HTML -BUILT_SOURCES = nano.1.html nanorc.5.html rnano.1.html -endif -else -man_MANS = nano.1 rnano.1 -if GROFF_HTML -BUILT_SOURCES = nano.1.html rnano.1.html -endif +dist_man_MANS += nanorc.5 +html_pages += nanorc.5.html endif -nano_man_mans = nano.1 nanorc.5 rnano.1 -if GROFF_HTML -htmlman_DATA = nano.1.html nanorc.5.html rnano.1.html -htmlmandir = $(datadir)/nano/man-html -nano_built_sources = nano.1.html nanorc.5.html rnano.1.html - nano.1.html: nano.1 groff -t -mandoc -Thtml < $? > $@ nanorc.5.html: nanorc.5 @@ -29,7 +20,9 @@ nanorc.5.html: nanorc.5 rnano.1.html: rnano.1 groff -t -mandoc -Thtml < $? > $@ -EXTRA_DIST = $(nano_man_mans) $(nano_built_sources) -else -EXTRA_DIST = $(nano_man_mans) +if GROFF_HTML +BUILT_SOURCES += $(html_pages) +dist_html_DATA = $(html_pages) endif + +EXTRA_DIST = $(BUILT_SOURCES) diff --git a/doc/man/Makefile.in b/doc/man/Makefile.in index d2018c7f..45c454e9 100644 --- a/doc/man/Makefile.in +++ b/doc/man/Makefile.in @@ -1,9 +1,8 @@ -# Makefile.in generated by automake 1.11.6 from Makefile.am. +# Makefile.in generated by automake 1.13.3 from Makefile.am. # @configure_input@ -# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, -# 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software -# Foundation, Inc. +# Copyright (C) 1994-2013 Free Software Foundation, Inc. + # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, # with or without modifications, as long as this notice is preserved. @@ -16,23 +15,51 @@ @SET_MAKE@ VPATH = @srcdir@ -am__make_dryrun = \ - { \ - am__dry=no; \ +am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__make_running_with_option = \ + case $${target_option-} in \ + ?) ;; \ + *) echo "am__make_running_with_option: internal error: invalid" \ + "target option '$${target_option-}' specified" >&2; \ + exit 1;; \ + esac; \ + has_opt=no; \ + sane_makeflags=$$MAKEFLAGS; \ + if $(am__is_gnu_make); then \ + sane_makeflags=$$MFLAGS; \ + else \ case $$MAKEFLAGS in \ *\\[\ \ ]*) \ - echo 'am--echo: ; @echo "AM" OK' | $(MAKE) -f - 2>/dev/null \ - | grep '^AM OK$$' >/dev/null || am__dry=yes;; \ - *) \ - for am__flg in $$MAKEFLAGS; do \ - case $$am__flg in \ - *=*|--*) ;; \ - *n*) am__dry=yes; break;; \ - esac; \ - done;; \ + bs=\\; \ + sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \ + | sed "s/$$bs$$bs[$$bs $$bs ]*//g"`;; \ esac; \ - test $$am__dry = yes; \ - } + fi; \ + skip_next=no; \ + strip_trailopt () \ + { \ + flg=`printf '%s\n' "$$flg" | sed "s/$$1.*$$//"`; \ + }; \ + for flg in $$sane_makeflags; do \ + test $$skip_next = yes && { skip_next=no; continue; }; \ + case $$flg in \ + *=*|--*) continue;; \ + -*I) strip_trailopt 'I'; skip_next=yes;; \ + -*I?*) strip_trailopt 'I';; \ + -*O) strip_trailopt 'O'; skip_next=yes;; \ + -*O?*) strip_trailopt 'O';; \ + -*l) strip_trailopt 'l'; skip_next=yes;; \ + -*l?*) strip_trailopt 'l';; \ + -[dEDm]) skip_next=yes;; \ + -[JT]) skip_next=yes;; \ + esac; \ + case $$flg in \ + *$$target_option*) has_opt=yes; break;; \ + esac; \ + done; \ + test $$has_opt = yes +am__make_dryrun = (target_option=n; $(am__make_running_with_option)) +am__make_keepgoing = (target_option=k; $(am__make_running_with_option)) pkgdatadir = $(datadir)/@PACKAGE@ pkgincludedir = $(includedir)/@PACKAGE@ pkglibdir = $(libdir)/@PACKAGE@ @@ -51,10 +78,17 @@ PRE_UNINSTALL = : POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ +@USE_NLS_TRUE@am__append_1 = fr +@USE_NANORC_TRUE@am__append_2 = nanorc.5 +@USE_NANORC_TRUE@am__append_3 = nanorc.5.html +@GROFF_HTML_TRUE@am__append_4 = $(html_pages) subdir = doc/man -DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in +DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ + $(top_srcdir)/mkinstalldirs $(dist_man_MANS) \ + $(am__dist_html_DATA_DIST) ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ac_define_dir.m4 \ + $(top_srcdir)/m4/ax_check_compile_flag.m4 \ $(top_srcdir)/m4/gettext.m4 $(top_srcdir)/m4/glib-2.0.m4 \ $(top_srcdir)/m4/iconv.m4 $(top_srcdir)/m4/isc-posix.m4 \ $(top_srcdir)/m4/lib-ld.m4 $(top_srcdir)/m4/lib-link.m4 \ @@ -66,15 +100,28 @@ mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = CONFIG_CLEAN_VPATH_FILES = +AM_V_P = $(am__v_P_@AM_V@) +am__v_P_ = $(am__v_P_@AM_DEFAULT_V@) +am__v_P_0 = false +am__v_P_1 = : +AM_V_GEN = $(am__v_GEN_@AM_V@) +am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@) +am__v_GEN_0 = @echo " GEN " $@; +am__v_GEN_1 = +AM_V_at = $(am__v_at_@AM_V@) +am__v_at_ = $(am__v_at_@AM_DEFAULT_V@) +am__v_at_0 = @ +am__v_at_1 = SOURCES = DIST_SOURCES = -RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ - html-recursive info-recursive install-data-recursive \ - install-dvi-recursive install-exec-recursive \ - install-html-recursive install-info-recursive \ - install-pdf-recursive install-ps-recursive install-recursive \ - installcheck-recursive installdirs-recursive pdf-recursive \ - ps-recursive uninstall-recursive +RECURSIVE_TARGETS = all-recursive check-recursive cscopelist-recursive \ + ctags-recursive dvi-recursive html-recursive info-recursive \ + install-data-recursive install-dvi-recursive \ + install-exec-recursive install-html-recursive \ + install-info-recursive install-pdf-recursive \ + install-ps-recursive install-recursive installcheck-recursive \ + installdirs-recursive pdf-recursive ps-recursive \ + tags-recursive uninstall-recursive am__can_run_installinfo = \ case $$AM_UPDATE_INFO_DIR in \ n|no|NO) false;; \ @@ -109,16 +156,37 @@ am__uninstall_files_from_dir = { \ } man1dir = $(mandir)/man1 am__installdirs = "$(DESTDIR)$(man1dir)" "$(DESTDIR)$(man5dir)" \ - "$(DESTDIR)$(htmlmandir)" + "$(DESTDIR)$(htmldir)" man5dir = $(mandir)/man5 NROFF = nroff -MANS = $(man_MANS) -DATA = $(htmlman_DATA) +MANS = $(dist_man_MANS) +am__dist_html_DATA_DIST = nano.1.html rnano.1.html nanorc.5.html +DATA = $(dist_html_DATA) RECURSIVE_CLEAN_TARGETS = mostlyclean-recursive clean-recursive \ distclean-recursive maintainer-clean-recursive -AM_RECURSIVE_TARGETS = $(RECURSIVE_TARGETS:-recursive=) \ - $(RECURSIVE_CLEAN_TARGETS:-recursive=) tags TAGS ctags CTAGS \ +am__recursive_targets = \ + $(RECURSIVE_TARGETS) \ + $(RECURSIVE_CLEAN_TARGETS) \ + $(am__extra_recursive_targets) +AM_RECURSIVE_TARGETS = $(am__recursive_targets:-recursive=) TAGS CTAGS \ distdir +am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +# Read a list of newline-separated strings from the standard input, +# and print each of them once, without duplicates. Input order is +# *not* preserved. +am__uniquify_input = $(AWK) '\ + BEGIN { nonempty = 0; } \ + { items[$$0] = 1; nonempty = 1; } \ + END { if (nonempty) { for (i in items) print i; }; } \ +' +# Make sure the list of sources is unique. This is necessary because, +# e.g., the same source file might be shared among _SOURCES variables +# for different programs/libraries. +am__define_uniq_tagged_files = \ + list='$(am__tagged_files)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | $(am__uniquify_input)` ETAGS = etags CTAGS = ctags DIST_SUBDIRS = fr @@ -150,6 +218,7 @@ am__relativize = \ reldir="$$dir2" ACLOCAL = @ACLOCAL@ AMTAR = @AMTAR@ +AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ @@ -195,7 +264,11 @@ MKDIR_P = @MKDIR_P@ MKINSTALLDIRS = @MKINSTALLDIRS@ MSGFMT = @MSGFMT@ MSGMERGE = @MSGMERGE@ +NCURSESW_CFLAGS = @NCURSESW_CFLAGS@ NCURSESW_CONFIG = @NCURSESW_CONFIG@ +NCURSESW_LIBS = @NCURSESW_LIBS@ +NCURSES_CFLAGS = @NCURSES_CFLAGS@ +NCURSES_LIBS = @NCURSES_LIBS@ OBJEXT = @OBJEXT@ PACKAGE = @PACKAGE@ PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ @@ -207,6 +280,8 @@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ PKGDATADIR = @PKGDATADIR@ PKG_CONFIG = @PKG_CONFIG@ +PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@ +PKG_CONFIG_PATH = @PKG_CONFIG_PATH@ POSUB = @POSUB@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ @@ -236,6 +311,7 @@ datarootdir = @datarootdir@ docdir = @docdir@ dvidir = @dvidir@ exec_prefix = @exec_prefix@ +haveit = @haveit@ host = @host@ host_alias = @host_alias@ host_cpu = @host_cpu@ @@ -264,18 +340,12 @@ target_alias = @target_alias@ top_build_prefix = @top_build_prefix@ top_builddir = @top_builddir@ top_srcdir = @top_srcdir@ -@USE_NLS_FALSE@SUBDIRS = -@USE_NLS_TRUE@SUBDIRS = fr -@USE_NANORC_FALSE@man_MANS = nano.1 rnano.1 -@USE_NANORC_TRUE@man_MANS = nano.1 nanorc.5 rnano.1 -@GROFF_HTML_TRUE@@USE_NANORC_FALSE@BUILT_SOURCES = nano.1.html rnano.1.html -@GROFF_HTML_TRUE@@USE_NANORC_TRUE@BUILT_SOURCES = nano.1.html nanorc.5.html rnano.1.html -nano_man_mans = nano.1 nanorc.5 rnano.1 -@GROFF_HTML_TRUE@htmlman_DATA = nano.1.html nanorc.5.html rnano.1.html -@GROFF_HTML_TRUE@htmlmandir = $(datadir)/nano/man-html -@GROFF_HTML_TRUE@nano_built_sources = nano.1.html nanorc.5.html rnano.1.html -@GROFF_HTML_FALSE@EXTRA_DIST = $(nano_man_mans) -@GROFF_HTML_TRUE@EXTRA_DIST = $(nano_man_mans) $(nano_built_sources) +SUBDIRS = $(am__append_1) +BUILT_SOURCES = $(am__append_4) +dist_man_MANS = nano.1 rnano.1 $(am__append_2) +html_pages = nano.1.html rnano.1.html $(am__append_3) +@GROFF_HTML_TRUE@dist_html_DATA = $(html_pages) +EXTRA_DIST = $(BUILT_SOURCES) all: $(BUILT_SOURCES) $(MAKE) $(AM_MAKEFLAGS) all-recursive @@ -310,10 +380,10 @@ $(top_srcdir)/configure: $(am__configure_deps) $(ACLOCAL_M4): $(am__aclocal_m4_deps) cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh $(am__aclocal_m4_deps): -install-man1: $(man_MANS) +install-man1: $(dist_man_MANS) @$(NORMAL_INSTALL) @list1=''; \ - list2='$(man_MANS)'; \ + list2='$(dist_man_MANS)'; \ test -n "$(man1dir)" \ && test -n "`echo $$list1$$list2`" \ || exit 0; \ @@ -348,15 +418,15 @@ uninstall-man1: @$(NORMAL_UNINSTALL) @list=''; test -n "$(man1dir)" || exit 0; \ files=`{ for i in $$list; do echo "$$i"; done; \ - l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + l2='$(dist_man_MANS)'; for i in $$l2; do echo "$$i"; done | \ sed -n '/\.1[a-z]*$$/p'; \ } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ dir='$(DESTDIR)$(man1dir)'; $(am__uninstall_files_from_dir) -install-man5: $(man_MANS) +install-man5: $(dist_man_MANS) @$(NORMAL_INSTALL) @list1=''; \ - list2='$(man_MANS)'; \ + list2='$(dist_man_MANS)'; \ test -n "$(man5dir)" \ && test -n "`echo $$list1$$list2`" \ || exit 0; \ @@ -391,50 +461,53 @@ uninstall-man5: @$(NORMAL_UNINSTALL) @list=''; test -n "$(man5dir)" || exit 0; \ files=`{ for i in $$list; do echo "$$i"; done; \ - l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + l2='$(dist_man_MANS)'; for i in $$l2; do echo "$$i"; done | \ sed -n '/\.5[a-z]*$$/p'; \ } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^5][0-9a-z]*$$,5,;x' \ -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ dir='$(DESTDIR)$(man5dir)'; $(am__uninstall_files_from_dir) -install-htmlmanDATA: $(htmlman_DATA) +install-dist_htmlDATA: $(dist_html_DATA) @$(NORMAL_INSTALL) - @list='$(htmlman_DATA)'; test -n "$(htmlmandir)" || list=; \ + @list='$(dist_html_DATA)'; test -n "$(htmldir)" || list=; \ if test -n "$$list"; then \ - echo " $(MKDIR_P) '$(DESTDIR)$(htmlmandir)'"; \ - $(MKDIR_P) "$(DESTDIR)$(htmlmandir)" || exit 1; \ + echo " $(MKDIR_P) '$(DESTDIR)$(htmldir)'"; \ + $(MKDIR_P) "$(DESTDIR)$(htmldir)" || exit 1; \ fi; \ for p in $$list; do \ if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ echo "$$d$$p"; \ done | $(am__base_list) | \ while read files; do \ - echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(htmlmandir)'"; \ - $(INSTALL_DATA) $$files "$(DESTDIR)$(htmlmandir)" || exit $$?; \ + echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(htmldir)'"; \ + $(INSTALL_DATA) $$files "$(DESTDIR)$(htmldir)" || exit $$?; \ done -uninstall-htmlmanDATA: +uninstall-dist_htmlDATA: @$(NORMAL_UNINSTALL) - @list='$(htmlman_DATA)'; test -n "$(htmlmandir)" || list=; \ + @list='$(dist_html_DATA)'; test -n "$(htmldir)" || list=; \ files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \ - dir='$(DESTDIR)$(htmlmandir)'; $(am__uninstall_files_from_dir) + dir='$(DESTDIR)$(htmldir)'; $(am__uninstall_files_from_dir) # This directory's subdirectories are mostly independent; you can cd -# into them and run `make' without going through this Makefile. -# To change the values of `make' variables: instead of editing Makefiles, -# (1) if the variable is set in `config.status', edit `config.status' -# (which will cause the Makefiles to be regenerated when you run `make'); -# (2) otherwise, pass the desired values on the `make' command line. -$(RECURSIVE_TARGETS): - @fail= failcom='exit 1'; \ - for f in x $$MAKEFLAGS; do \ - case $$f in \ - *=* | --[!k]*);; \ - *k*) failcom='fail=yes';; \ - esac; \ - done; \ +# into them and run 'make' without going through this Makefile. +# To change the values of 'make' variables: instead of editing Makefiles, +# (1) if the variable is set in 'config.status', edit 'config.status' +# (which will cause the Makefiles to be regenerated when you run 'make'); +# (2) otherwise, pass the desired values on the 'make' command line. +$(am__recursive_targets): + @fail=; \ + if $(am__make_keepgoing); then \ + failcom='fail=yes'; \ + else \ + failcom='exit 1'; \ + fi; \ dot_seen=no; \ target=`echo $@ | sed s/-recursive//`; \ - list='$(SUBDIRS)'; for subdir in $$list; do \ + case "$@" in \ + distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ + *) list='$(SUBDIRS)' ;; \ + esac; \ + for subdir in $$list; do \ echo "Making $$target in $$subdir"; \ if test "$$subdir" = "."; then \ dot_seen=yes; \ @@ -449,57 +522,12 @@ $(RECURSIVE_TARGETS): $(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \ fi; test -z "$$fail" -$(RECURSIVE_CLEAN_TARGETS): - @fail= failcom='exit 1'; \ - for f in x $$MAKEFLAGS; do \ - case $$f in \ - *=* | --[!k]*);; \ - *k*) failcom='fail=yes';; \ - esac; \ - done; \ - dot_seen=no; \ - case "$@" in \ - distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ - *) list='$(SUBDIRS)' ;; \ - esac; \ - rev=''; for subdir in $$list; do \ - if test "$$subdir" = "."; then :; else \ - rev="$$subdir $$rev"; \ - fi; \ - done; \ - rev="$$rev ."; \ - target=`echo $@ | sed s/-recursive//`; \ - for subdir in $$rev; do \ - echo "Making $$target in $$subdir"; \ - if test "$$subdir" = "."; then \ - local_target="$$target-am"; \ - else \ - local_target="$$target"; \ - fi; \ - ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ - || eval $$failcom; \ - done && test -z "$$fail" -tags-recursive: - list='$(SUBDIRS)'; for subdir in $$list; do \ - test "$$subdir" = . || ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \ - done -ctags-recursive: - list='$(SUBDIRS)'; for subdir in $$list; do \ - test "$$subdir" = . || ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \ - done +ID: $(am__tagged_files) + $(am__define_uniq_tagged_files); mkid -fID $$unique +tags: tags-recursive +TAGS: tags -ID: $(HEADERS) $(SOURCES) $(LISP) $(TAGS_FILES) - list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ - unique=`for i in $$list; do \ - if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ - done | \ - $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ - END { if (nonempty) { for (i in files) print i; }; }'`; \ - mkid -fID $$unique -tags: TAGS - -TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ - $(TAGS_FILES) $(LISP) +tags-am: $(TAGS_DEPENDENCIES) $(am__tagged_files) set x; \ here=`pwd`; \ if ($(ETAGS) --etags-include --version) >/dev/null 2>&1; then \ @@ -515,12 +543,7 @@ TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ set "$$@" "$$include_option=$$here/$$subdir/TAGS"; \ fi; \ done; \ - list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ - unique=`for i in $$list; do \ - if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ - done | \ - $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ - END { if (nonempty) { for (i in files) print i; }; }'`; \ + $(am__define_uniq_tagged_files); \ shift; \ if test -z "$(ETAGS_ARGS)$$*$$unique"; then :; else \ test -n "$$unique" || unique=$$empty_fix; \ @@ -532,15 +555,11 @@ TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ $$unique; \ fi; \ fi -ctags: CTAGS -CTAGS: ctags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ - $(TAGS_FILES) $(LISP) - list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ - unique=`for i in $$list; do \ - if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ - done | \ - $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ - END { if (nonempty) { for (i in files) print i; }; }'`; \ +ctags: ctags-recursive + +CTAGS: ctags +ctags-am: $(TAGS_DEPENDENCIES) $(am__tagged_files) + $(am__define_uniq_tagged_files); \ test -z "$(CTAGS_ARGS)$$unique" \ || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \ $$unique @@ -549,24 +568,26 @@ GTAGS: here=`$(am__cd) $(top_builddir) && pwd` \ && $(am__cd) $(top_srcdir) \ && gtags -i $(GTAGS_ARGS) "$$here" +cscopelist: cscopelist-recursive + +cscopelist-am: $(am__tagged_files) + list='$(am__tagged_files)'; \ + case "$(srcdir)" in \ + [\\/]* | ?:[\\/]*) sdir="$(srcdir)" ;; \ + *) sdir=$(subdir)/$(srcdir) ;; \ + esac; \ + for i in $$list; do \ + if test -f "$$i"; then \ + echo "$(subdir)/$$i"; \ + else \ + echo "$$sdir/$$i"; \ + fi; \ + done >> $(top_builddir)/cscope.files distclean-tags: -rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags distdir: $(DISTFILES) - @list='$(MANS)'; if test -n "$$list"; then \ - list=`for p in $$list; do \ - if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ - if test -f "$$d$$p"; then echo "$$d$$p"; else :; fi; done`; \ - if test -n "$$list" && \ - grep 'ab help2man is required to generate this page' $$list >/dev/null; then \ - echo "error: found man pages containing the \`missing help2man' replacement text:" >&2; \ - grep -l 'ab help2man is required to generate this page' $$list | sed 's/^/ /' >&2; \ - echo " to fix them, install help2man, remove and regenerate the man pages;" >&2; \ - echo " typically \`make maintainer-clean' will remove them" >&2; \ - exit 1; \ - else :; fi; \ - else :; fi @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ list='$(DISTFILES)'; \ @@ -627,7 +648,7 @@ check: $(BUILT_SOURCES) all-am: Makefile $(MANS) $(DATA) installdirs: installdirs-recursive installdirs-am: - for dir in "$(DESTDIR)$(man1dir)" "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(htmlmandir)"; do \ + for dir in "$(DESTDIR)$(man1dir)" "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(htmldir)"; do \ test -z "$$dir" || $(MKDIR_P) "$$dir"; \ done install: $(BUILT_SOURCES) @@ -682,7 +703,7 @@ info: info-recursive info-am: -install-data-am: install-htmlmanDATA install-man +install-data-am: install-dist_htmlDATA install-man install-dvi: install-dvi-recursive @@ -726,36 +747,35 @@ ps: ps-recursive ps-am: -uninstall-am: uninstall-htmlmanDATA uninstall-man +uninstall-am: uninstall-dist_htmlDATA uninstall-man uninstall-man: uninstall-man1 uninstall-man5 -.MAKE: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) all check \ - ctags-recursive install install-am install-strip \ - tags-recursive +.MAKE: $(am__recursive_targets) all check install install-am \ + install-strip -.PHONY: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) CTAGS GTAGS \ - all all-am check check-am clean clean-generic ctags \ - ctags-recursive distclean distclean-generic distclean-tags \ - distdir dvi dvi-am html html-am info info-am install \ - install-am install-data install-data-am install-dvi \ +.PHONY: $(am__recursive_targets) CTAGS GTAGS TAGS all all-am check \ + check-am clean clean-generic cscopelist-am ctags ctags-am \ + distclean distclean-generic distclean-tags distdir dvi dvi-am \ + html html-am info info-am install install-am install-data \ + install-data-am install-dist_htmlDATA install-dvi \ install-dvi-am install-exec install-exec-am install-html \ - install-html-am install-htmlmanDATA install-info \ - install-info-am install-man install-man1 install-man5 \ - install-pdf install-pdf-am install-ps install-ps-am \ - install-strip installcheck installcheck-am installdirs \ - installdirs-am maintainer-clean maintainer-clean-generic \ - mostlyclean mostlyclean-generic pdf pdf-am ps ps-am tags \ - tags-recursive uninstall uninstall-am uninstall-htmlmanDATA \ - uninstall-man uninstall-man1 uninstall-man5 - - -@GROFF_HTML_TRUE@nano.1.html: nano.1 -@GROFF_HTML_TRUE@ groff -t -mandoc -Thtml < $? > $@ -@GROFF_HTML_TRUE@nanorc.5.html: nanorc.5 -@GROFF_HTML_TRUE@ groff -t -mandoc -Thtml < $? > $@ -@GROFF_HTML_TRUE@rnano.1.html: rnano.1 -@GROFF_HTML_TRUE@ groff -t -mandoc -Thtml < $? > $@ + install-html-am install-info install-info-am install-man \ + install-man1 install-man5 install-pdf install-pdf-am \ + install-ps install-ps-am install-strip installcheck \ + installcheck-am installdirs installdirs-am maintainer-clean \ + maintainer-clean-generic mostlyclean mostlyclean-generic pdf \ + pdf-am ps ps-am tags tags-am uninstall uninstall-am \ + uninstall-dist_htmlDATA uninstall-man uninstall-man1 \ + uninstall-man5 + + +nano.1.html: nano.1 + groff -t -mandoc -Thtml < $? > $@ +nanorc.5.html: nanorc.5 + groff -t -mandoc -Thtml < $? > $@ +rnano.1.html: rnano.1 + groff -t -mandoc -Thtml < $? > $@ # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/doc/man/fr/Makefile.am b/doc/man/fr/Makefile.am index 7a430520..d8c2d18c 100644 --- a/doc/man/fr/Makefile.am +++ b/doc/man/fr/Makefile.am @@ -1,23 +1,15 @@ mandir = @mandir@/fr +htmldir = @htmldir@/fr -if USE_NANORC -man_MANS = nano.1 nanorc.5 rnano.1 -if GROFF_HTML -BUILT_SOURCES = nano.1.html nanorc.5.html rnano.1.html -endif -else -man_MANS = nano.1 rnano.1 -if GROFF_HTML -BUILT_SOURCES = nano.1.html rnano.1.html -endif -endif +BUILT_SOURCES = -nano_man_mans = nano.1 nanorc.5 rnano.1 -if GROFF_HTML -htmlman_DATA = nano.1.html nanorc.5.html rnano.1.html -htmlmandir = $(datadir)/nano/man-html/fr +dist_man_MANS = nano.1 rnano.1 +html_pages = nano.1.html rnano.1.html -nano_built_sources = nano.1.html nanorc.5.html rnano.1.html +if USE_NANORC +dist_man_MANS += nanorc.5 +html_pages += nanorc.5.html +endif nano.1.html: nano.1 groff -t -mandoc -Thtml < $? > $@ @@ -26,8 +18,9 @@ nanorc.5.html: nanorc.5 rnano.1.html: rnano.1 groff -t -mandoc -Thtml < $? > $@ -EXTRA_DIST = $(nano_man_mans) $(nano_built_sources) -else -EXTRA_DIST = $(nano_man_mans) +if GROFF_HTML +BUILT_SOURCES += $(html_pages) +dist_html_DATA = $(html_pages) endif +EXTRA_DIST = $(BUILT_SOURCES) diff --git a/doc/man/fr/Makefile.in b/doc/man/fr/Makefile.in index 8d83bf24..d8cfc5da 100644 --- a/doc/man/fr/Makefile.in +++ b/doc/man/fr/Makefile.in @@ -1,9 +1,8 @@ -# Makefile.in generated by automake 1.11.6 from Makefile.am. +# Makefile.in generated by automake 1.13.3 from Makefile.am. # @configure_input@ -# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, -# 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software -# Foundation, Inc. +# Copyright (C) 1994-2013 Free Software Foundation, Inc. + # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, # with or without modifications, as long as this notice is preserved. @@ -16,23 +15,51 @@ @SET_MAKE@ VPATH = @srcdir@ -am__make_dryrun = \ - { \ - am__dry=no; \ +am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__make_running_with_option = \ + case $${target_option-} in \ + ?) ;; \ + *) echo "am__make_running_with_option: internal error: invalid" \ + "target option '$${target_option-}' specified" >&2; \ + exit 1;; \ + esac; \ + has_opt=no; \ + sane_makeflags=$$MAKEFLAGS; \ + if $(am__is_gnu_make); then \ + sane_makeflags=$$MFLAGS; \ + else \ case $$MAKEFLAGS in \ *\\[\ \ ]*) \ - echo 'am--echo: ; @echo "AM" OK' | $(MAKE) -f - 2>/dev/null \ - | grep '^AM OK$$' >/dev/null || am__dry=yes;; \ - *) \ - for am__flg in $$MAKEFLAGS; do \ - case $$am__flg in \ - *=*|--*) ;; \ - *n*) am__dry=yes; break;; \ - esac; \ - done;; \ + bs=\\; \ + sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \ + | sed "s/$$bs$$bs[$$bs $$bs ]*//g"`;; \ esac; \ - test $$am__dry = yes; \ - } + fi; \ + skip_next=no; \ + strip_trailopt () \ + { \ + flg=`printf '%s\n' "$$flg" | sed "s/$$1.*$$//"`; \ + }; \ + for flg in $$sane_makeflags; do \ + test $$skip_next = yes && { skip_next=no; continue; }; \ + case $$flg in \ + *=*|--*) continue;; \ + -*I) strip_trailopt 'I'; skip_next=yes;; \ + -*I?*) strip_trailopt 'I';; \ + -*O) strip_trailopt 'O'; skip_next=yes;; \ + -*O?*) strip_trailopt 'O';; \ + -*l) strip_trailopt 'l'; skip_next=yes;; \ + -*l?*) strip_trailopt 'l';; \ + -[dEDm]) skip_next=yes;; \ + -[JT]) skip_next=yes;; \ + esac; \ + case $$flg in \ + *$$target_option*) has_opt=yes; break;; \ + esac; \ + done; \ + test $$has_opt = yes +am__make_dryrun = (target_option=n; $(am__make_running_with_option)) +am__make_keepgoing = (target_option=k; $(am__make_running_with_option)) pkgdatadir = $(datadir)/@PACKAGE@ pkgincludedir = $(includedir)/@PACKAGE@ pkglibdir = $(libdir)/@PACKAGE@ @@ -51,10 +78,16 @@ PRE_UNINSTALL = : POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ +@USE_NANORC_TRUE@am__append_1 = nanorc.5 +@USE_NANORC_TRUE@am__append_2 = nanorc.5.html +@GROFF_HTML_TRUE@am__append_3 = $(html_pages) subdir = doc/man/fr -DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in +DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ + $(top_srcdir)/mkinstalldirs $(dist_man_MANS) \ + $(am__dist_html_DATA_DIST) ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ac_define_dir.m4 \ + $(top_srcdir)/m4/ax_check_compile_flag.m4 \ $(top_srcdir)/m4/gettext.m4 $(top_srcdir)/m4/glib-2.0.m4 \ $(top_srcdir)/m4/iconv.m4 $(top_srcdir)/m4/isc-posix.m4 \ $(top_srcdir)/m4/lib-ld.m4 $(top_srcdir)/m4/lib-link.m4 \ @@ -66,6 +99,18 @@ mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = CONFIG_CLEAN_VPATH_FILES = +AM_V_P = $(am__v_P_@AM_V@) +am__v_P_ = $(am__v_P_@AM_DEFAULT_V@) +am__v_P_0 = false +am__v_P_1 = : +AM_V_GEN = $(am__v_GEN_@AM_V@) +am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@) +am__v_GEN_0 = @echo " GEN " $@; +am__v_GEN_1 = +AM_V_at = $(am__v_at_@AM_V@) +am__v_at_ = $(am__v_at_@AM_DEFAULT_V@) +am__v_at_0 = @ +am__v_at_1 = SOURCES = DIST_SOURCES = am__can_run_installinfo = \ @@ -102,14 +147,17 @@ am__uninstall_files_from_dir = { \ } man1dir = $(mandir)/man1 am__installdirs = "$(DESTDIR)$(man1dir)" "$(DESTDIR)$(man5dir)" \ - "$(DESTDIR)$(htmlmandir)" + "$(DESTDIR)$(htmldir)" man5dir = $(mandir)/man5 NROFF = nroff -MANS = $(man_MANS) -DATA = $(htmlman_DATA) +MANS = $(dist_man_MANS) +am__dist_html_DATA_DIST = nano.1.html rnano.1.html nanorc.5.html +DATA = $(dist_html_DATA) +am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ AMTAR = @AMTAR@ +AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ @@ -155,7 +203,11 @@ MKDIR_P = @MKDIR_P@ MKINSTALLDIRS = @MKINSTALLDIRS@ MSGFMT = @MSGFMT@ MSGMERGE = @MSGMERGE@ +NCURSESW_CFLAGS = @NCURSESW_CFLAGS@ NCURSESW_CONFIG = @NCURSESW_CONFIG@ +NCURSESW_LIBS = @NCURSESW_LIBS@ +NCURSES_CFLAGS = @NCURSES_CFLAGS@ +NCURSES_LIBS = @NCURSES_LIBS@ OBJEXT = @OBJEXT@ PACKAGE = @PACKAGE@ PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ @@ -167,6 +219,8 @@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ PKGDATADIR = @PKGDATADIR@ PKG_CONFIG = @PKG_CONFIG@ +PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@ +PKG_CONFIG_PATH = @PKG_CONFIG_PATH@ POSUB = @POSUB@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ @@ -196,12 +250,13 @@ datarootdir = @datarootdir@ docdir = @docdir@ dvidir = @dvidir@ exec_prefix = @exec_prefix@ +haveit = @haveit@ host = @host@ host_alias = @host_alias@ host_cpu = @host_cpu@ host_os = @host_os@ host_vendor = @host_vendor@ -htmldir = @htmldir@ +htmldir = @htmldir@/fr includedir = @includedir@ infodir = @infodir@ install_sh = @install_sh@ @@ -224,16 +279,11 @@ target_alias = @target_alias@ top_build_prefix = @top_build_prefix@ top_builddir = @top_builddir@ top_srcdir = @top_srcdir@ -@USE_NANORC_FALSE@man_MANS = nano.1 rnano.1 -@USE_NANORC_TRUE@man_MANS = nano.1 nanorc.5 rnano.1 -@GROFF_HTML_TRUE@@USE_NANORC_FALSE@BUILT_SOURCES = nano.1.html rnano.1.html -@GROFF_HTML_TRUE@@USE_NANORC_TRUE@BUILT_SOURCES = nano.1.html nanorc.5.html rnano.1.html -nano_man_mans = nano.1 nanorc.5 rnano.1 -@GROFF_HTML_TRUE@htmlman_DATA = nano.1.html nanorc.5.html rnano.1.html -@GROFF_HTML_TRUE@htmlmandir = $(datadir)/nano/man-html/fr -@GROFF_HTML_TRUE@nano_built_sources = nano.1.html nanorc.5.html rnano.1.html -@GROFF_HTML_FALSE@EXTRA_DIST = $(nano_man_mans) -@GROFF_HTML_TRUE@EXTRA_DIST = $(nano_man_mans) $(nano_built_sources) +BUILT_SOURCES = $(am__append_3) +dist_man_MANS = nano.1 rnano.1 $(am__append_1) +html_pages = nano.1.html rnano.1.html $(am__append_2) +@GROFF_HTML_TRUE@dist_html_DATA = $(html_pages) +EXTRA_DIST = $(BUILT_SOURCES) all: $(BUILT_SOURCES) $(MAKE) $(AM_MAKEFLAGS) all-am @@ -268,10 +318,10 @@ $(top_srcdir)/configure: $(am__configure_deps) $(ACLOCAL_M4): $(am__aclocal_m4_deps) cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh $(am__aclocal_m4_deps): -install-man1: $(man_MANS) +install-man1: $(dist_man_MANS) @$(NORMAL_INSTALL) @list1=''; \ - list2='$(man_MANS)'; \ + list2='$(dist_man_MANS)'; \ test -n "$(man1dir)" \ && test -n "`echo $$list1$$list2`" \ || exit 0; \ @@ -306,15 +356,15 @@ uninstall-man1: @$(NORMAL_UNINSTALL) @list=''; test -n "$(man1dir)" || exit 0; \ files=`{ for i in $$list; do echo "$$i"; done; \ - l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + l2='$(dist_man_MANS)'; for i in $$l2; do echo "$$i"; done | \ sed -n '/\.1[a-z]*$$/p'; \ } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ dir='$(DESTDIR)$(man1dir)'; $(am__uninstall_files_from_dir) -install-man5: $(man_MANS) +install-man5: $(dist_man_MANS) @$(NORMAL_INSTALL) @list1=''; \ - list2='$(man_MANS)'; \ + list2='$(dist_man_MANS)'; \ test -n "$(man5dir)" \ && test -n "`echo $$list1$$list2`" \ || exit 0; \ @@ -349,53 +399,40 @@ uninstall-man5: @$(NORMAL_UNINSTALL) @list=''; test -n "$(man5dir)" || exit 0; \ files=`{ for i in $$list; do echo "$$i"; done; \ - l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + l2='$(dist_man_MANS)'; for i in $$l2; do echo "$$i"; done | \ sed -n '/\.5[a-z]*$$/p'; \ } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^5][0-9a-z]*$$,5,;x' \ -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ dir='$(DESTDIR)$(man5dir)'; $(am__uninstall_files_from_dir) -install-htmlmanDATA: $(htmlman_DATA) +install-dist_htmlDATA: $(dist_html_DATA) @$(NORMAL_INSTALL) - @list='$(htmlman_DATA)'; test -n "$(htmlmandir)" || list=; \ + @list='$(dist_html_DATA)'; test -n "$(htmldir)" || list=; \ if test -n "$$list"; then \ - echo " $(MKDIR_P) '$(DESTDIR)$(htmlmandir)'"; \ - $(MKDIR_P) "$(DESTDIR)$(htmlmandir)" || exit 1; \ + echo " $(MKDIR_P) '$(DESTDIR)$(htmldir)'"; \ + $(MKDIR_P) "$(DESTDIR)$(htmldir)" || exit 1; \ fi; \ for p in $$list; do \ if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ echo "$$d$$p"; \ done | $(am__base_list) | \ while read files; do \ - echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(htmlmandir)'"; \ - $(INSTALL_DATA) $$files "$(DESTDIR)$(htmlmandir)" || exit $$?; \ + echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(htmldir)'"; \ + $(INSTALL_DATA) $$files "$(DESTDIR)$(htmldir)" || exit $$?; \ done -uninstall-htmlmanDATA: +uninstall-dist_htmlDATA: @$(NORMAL_UNINSTALL) - @list='$(htmlman_DATA)'; test -n "$(htmlmandir)" || list=; \ + @list='$(dist_html_DATA)'; test -n "$(htmldir)" || list=; \ files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \ - dir='$(DESTDIR)$(htmlmandir)'; $(am__uninstall_files_from_dir) -tags: TAGS -TAGS: + dir='$(DESTDIR)$(htmldir)'; $(am__uninstall_files_from_dir) +tags TAGS: + +ctags CTAGS: -ctags: CTAGS -CTAGS: +cscope cscopelist: distdir: $(DISTFILES) - @list='$(MANS)'; if test -n "$$list"; then \ - list=`for p in $$list; do \ - if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ - if test -f "$$d$$p"; then echo "$$d$$p"; else :; fi; done`; \ - if test -n "$$list" && \ - grep 'ab help2man is required to generate this page' $$list >/dev/null; then \ - echo "error: found man pages containing the \`missing help2man' replacement text:" >&2; \ - grep -l 'ab help2man is required to generate this page' $$list | sed 's/^/ /' >&2; \ - echo " to fix them, install help2man, remove and regenerate the man pages;" >&2; \ - echo " typically \`make maintainer-clean' will remove them" >&2; \ - exit 1; \ - else :; fi; \ - else :; fi @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ list='$(DISTFILES)'; \ @@ -430,7 +467,7 @@ check: $(BUILT_SOURCES) $(MAKE) $(AM_MAKEFLAGS) check-am all-am: Makefile $(MANS) $(DATA) installdirs: - for dir in "$(DESTDIR)$(man1dir)" "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(htmlmandir)"; do \ + for dir in "$(DESTDIR)$(man1dir)" "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(htmldir)"; do \ test -z "$$dir" || $(MKDIR_P) "$$dir"; \ done install: $(BUILT_SOURCES) @@ -485,7 +522,7 @@ info: info-am info-am: -install-data-am: install-htmlmanDATA install-man +install-data-am: install-dist_htmlDATA install-man install-dvi: install-dvi-am @@ -529,32 +566,33 @@ ps: ps-am ps-am: -uninstall-am: uninstall-htmlmanDATA uninstall-man +uninstall-am: uninstall-dist_htmlDATA uninstall-man uninstall-man: uninstall-man1 uninstall-man5 .MAKE: all check install install-am install-strip -.PHONY: all all-am check check-am clean clean-generic distclean \ - distclean-generic distdir dvi dvi-am html html-am info info-am \ - install install-am install-data install-data-am install-dvi \ +.PHONY: all all-am check check-am clean clean-generic cscopelist-am \ + ctags-am distclean distclean-generic distdir dvi dvi-am html \ + html-am info info-am install install-am install-data \ + install-data-am install-dist_htmlDATA install-dvi \ install-dvi-am install-exec install-exec-am install-html \ - install-html-am install-htmlmanDATA install-info \ - install-info-am install-man install-man1 install-man5 \ - install-pdf install-pdf-am install-ps install-ps-am \ - install-strip installcheck installcheck-am installdirs \ - maintainer-clean maintainer-clean-generic mostlyclean \ - mostlyclean-generic pdf pdf-am ps ps-am uninstall uninstall-am \ - uninstall-htmlmanDATA uninstall-man uninstall-man1 \ + install-html-am install-info install-info-am install-man \ + install-man1 install-man5 install-pdf install-pdf-am \ + install-ps install-ps-am install-strip installcheck \ + installcheck-am installdirs maintainer-clean \ + maintainer-clean-generic mostlyclean mostlyclean-generic pdf \ + pdf-am ps ps-am tags-am uninstall uninstall-am \ + uninstall-dist_htmlDATA uninstall-man uninstall-man1 \ uninstall-man5 -@GROFF_HTML_TRUE@nano.1.html: nano.1 -@GROFF_HTML_TRUE@ groff -t -mandoc -Thtml < $? > $@ -@GROFF_HTML_TRUE@nanorc.5.html: nanorc.5 -@GROFF_HTML_TRUE@ groff -t -mandoc -Thtml < $? > $@ -@GROFF_HTML_TRUE@rnano.1.html: rnano.1 -@GROFF_HTML_TRUE@ groff -t -mandoc -Thtml < $? > $@ +nano.1.html: nano.1 + groff -t -mandoc -Thtml < $? > $@ +nanorc.5.html: nanorc.5 + groff -t -mandoc -Thtml < $? > $@ +rnano.1.html: rnano.1 + groff -t -mandoc -Thtml < $? > $@ # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. diff --git a/doc/man/fr/nano.1.html b/doc/man/fr/nano.1.html index c13e9a79..aaf85cab 100644 --- a/doc/man/fr/nano.1.html +++ b/doc/man/fr/nano.1.html @@ -1,5 +1,5 @@ -<!-- Creator : groff version 1.20.1 --> -<!-- CreationDate: Sat Jun 16 21:10:37 2012 --> +<!-- Creator : groff version 1.22.2 --> +<!-- CreationDate: Mon Feb 24 05:20:26 2014 --> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> diff --git a/doc/man/fr/nanorc.5.html b/doc/man/fr/nanorc.5.html index f2d77a96..5342d370 100644 --- a/doc/man/fr/nanorc.5.html +++ b/doc/man/fr/nanorc.5.html @@ -1,5 +1,5 @@ -<!-- Creator : groff version 1.20.1 --> -<!-- CreationDate: Sat Jun 16 21:10:38 2012 --> +<!-- Creator : groff version 1.22.2 --> +<!-- CreationDate: Mon Feb 24 05:20:26 2014 --> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> diff --git a/doc/man/fr/rnano.1.html b/doc/man/fr/rnano.1.html index 81d9b330..d0e6561d 100644 --- a/doc/man/fr/rnano.1.html +++ b/doc/man/fr/rnano.1.html @@ -1,5 +1,5 @@ -<!-- Creator : groff version 1.20.1 --> -<!-- CreationDate: Sat Jun 16 21:10:38 2012 --> +<!-- Creator : groff version 1.22.2 --> +<!-- CreationDate: Mon Feb 24 05:20:26 2014 --> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> diff --git a/doc/man/nano.1 b/doc/man/nano.1 index 4d4d67ac..15837321 100644 --- a/doc/man/nano.1 +++ b/doc/man/nano.1 @@ -1,6 +1,6 @@ .\" Hey, EMACS: -*- nroff -*- .\" Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, -.\" 2008, 2009 Free Software Foundation, Inc. +.\" 2009, 2010, 2013, 2014 Free Software Foundation, Inc. .\" .\" This document is dual-licensed. You may distribute and/or modify it .\" under the terms of either of the following licenses: @@ -18,8 +18,8 @@ .\" Documentation License along with this program. If not, see .\" <http://www.gnu.org/licenses/>. .\" -.\" $Id: nano.1 4549 2013-01-01 03:24:39Z astyanax $ -.TH NANO 1 "version 2.2.0" "November 30, 2009" +.\" $Id: nano.1 4846 2014-05-06 20:43:00Z bens $ +.TH NANO 1 "version 2.3.3" "April 2014" .\" Please adjust this date whenever revising the manpage. .\" @@ -28,30 +28,22 @@ nano \- Nano's ANOther editor, an enhanced free Pico clone .SH SYNOPSIS .B nano -.I [OPTIONS]\ [[\+LINE,COLUMN]\ FILE]... +.RI [ options "] [[\+" line , column "]\ " file "]..." .br .SH DESCRIPTION -This manual page briefly documents the \fBnano\fP command. -.PP -.\" TeX users may be more comfortable with the \fB<whatever>\fP and -.\" \fI<whatever>\fP escape sequences to invoke bold face and italics, -.\" respectively. \fBnano\fP is a small, free and friendly editor which aims to replace -Pico, the default editor included in the non-free Pine package. Rather -than just copying Pico's look and feel, \fBnano\fP also implements some +Pico, the default editor included in the non-free Pine package. On +top of copying Pico's look and feel, \fBnano\fP also implements some missing (or disabled by default) features in Pico, such as "search and replace" and "go to line and column number". .SH OPTIONS .TP -.B \+\fILINE\fP,\fICOLUMN\fP -Places cursor at line number \fILINE\fP and column number \fICOLUMN\fP +.B \+\fIline\fP,\fIcolumn\fP +Places the cursor on line number \fIline\fP and at column number \fIcolumn\fP (at least one of which must be specified) on startup, instead of the -default of line 1, column 1. -.TP -.B \-? -Same as \fB-h (\-\-help)\fP. +default line 1, column 1. .TP .B \-A (\-\-smarthome) Make the Home key smarter. When Home is pressed anywhere but at the @@ -62,10 +54,10 @@ line. .TP .B \-B (\-\-backup) When saving a file, back up the previous version of it to the current -filename suffixed with a ~. +filename suffixed with a tilde (\fB~\fP). .TP .B \-C \fIdir\fP (\-\-backupdir=\fIdir\fP) -Set the directory where \fBnano\fP puts unique backup files if file +Set the directory where \fBnano\fP puts unique backup files, if file backups are enabled. .TP .B \-D (\-\-boldtext) @@ -102,6 +94,10 @@ Disable automatic conversion of files from DOS/Mac format. .B \-O (\-\-morespace) Use the blank line below the titlebar as extra editing space. .TP +.B \-P (\-\-poslog) +Log and later read back the location of the cursor and place it there +again. +.TP .B \-Q \fIstr\fP (\-\-quotestr=\fIstr\fP) Set the quoting string for justifying. The default is "\fI^([\ \\t]*[#:>\\|}])+\fP" if extended regular expression support is @@ -110,23 +106,23 @@ Tab. .TP .B \-R (\-\-restricted) Restricted mode: don't read or write to any file not specified on the -command line; read any \fInanorc\fP files; allow suspending; allow a -file to be appended to, prepended to, or saved under a different name if -it already has one; or use backup files or spell checking. Also -accessible by invoking \fBnano\fP with any name beginning with 'r' (e.g. -"rnano"). +command line; don't read any \fInanorc\fP files; don't allow suspending; +don't allow a file to be appended to, prepended to, or saved under a +different name if it already has one; don't use backup files nor spell +checking. This restricted mode is also accessible by invoking \fBnano\fP +with any name beginning with 'r' (e.g. "rnano"). .TP .B \-S (\-\-smooth) Enable smooth scrolling. Text will scroll line-by-line, instead of the usual chunk-by-chunk behavior. .TP -.B \-T \fIcols\fP (\-\-tabsize=\fIcols\fP) -Set the size (width) of a tab to \fIcols\fP columns. The value of -\fIcols\fP must be greater than 0. The default value is 8. +.B \-T \fInumber\fP (\-\-tabsize=\fInumber\fP) +Set the size (width) of a tab to \fInumber\fP columns. The value of +\fInumber\fP must be greater than 0. The default value is 8. .TP .B \-U (\-\-quickblank) Do quick statusbar blanking. Statusbar messages will disappear after 1 -keystroke instead of 25. Note that \fB-c\fP overrides this. +keystroke instead of 25. Note that \fB\-c\fP overrides this. .TP .B \-V (\-\-version) Show the current version number and exit. @@ -140,7 +136,7 @@ Specify a specific syntax highlighting from the \fInanorc\fP to use, if available. .TP .B \-c (\-\-const) -Constantly show the cursor position. Note that this overrides \fB-U\fP. +Constantly show the cursor position. Note that this overrides \fB\-U\fP. .TP .B \-d (\-\-rebinddelete) Interpret the Delete key differently so that both Backspace and Delete @@ -148,14 +144,15 @@ work properly. You should only need to use this option if Backspace acts like Delete on your system. .TP .B \-h (\-\-help) -Show a summary of command line options and exit. +Show a summary of the available command-line options and exit. .TP .B \-i (\-\-autoindent) Indent new lines to the previous line's indentation. Useful when editing source code. .TP .B \-k (\-\-cut) -Enable cut from cursor to end of line. +Make the 'Cut Text' command (normally ^K) cut from the current cursor +position to the end of the line, instead of cutting the entire line. .TP .B \-l (\-\-nofollow) If the file being edited is a symbolic link, replace the link with @@ -166,7 +163,15 @@ a new file instead of following it. Good for editing files in Enable mouse support, if available for your system. When enabled, mouse clicks can be used to place the cursor, set the mark (with a double click), and execute shortcuts. The mouse will work in the X Window -System, and on the console when gpm is running. +System, and on the console when gpm is running. Text can still be +selected through dragging by holding down the Shift key. +.TP +.B \-n (\-\-noread) +Treat any name given on the command line as a new file. This allows +\fBnano\fR to write to named pipes: it will start with a blank buffer, +and will write to the pipe when the user saves the "file". This way +\fBnano\fR can be used as an editor in combination with for instance +\fBgpg\fR without having to write sensitive data to disk first. .TP .B \-o \fIdir\fP (\-\-operatingdir=\fIdir\fP) Set operating directory. Makes \fBnano\fP set up something similar to a @@ -177,41 +182,46 @@ Preserve the XON and XOFF sequences (^Q and ^S) so they will be caught by the terminal. .TP .B \-q (\-\-quiet) -Do not report errors in the \fInanorc\fP file and ask them to be +Do not report errors in the \fInanorc\fP file nor ask them to be acknowledged by pressing Enter at startup. .TP -.B \-r \fIcols\fP (\-\-fill=\fIcols\fP) -Wrap lines at column \fIcols\fP. If this value is 0 or less, wrapping -will occur at the width of the screen less \fIcols\fP columns, allowing +.B \-r \fInumber\fP (\-\-fill=\fInumber\fP) +Hard-wrap lines at column \fInumber\fP. If this value is 0 or less, wrapping +will occur at the width of the screen less \fInumber\fP columns, allowing the wrap point to vary along with the width of the screen if the screen -is resized. The default value is \-8. +is resized. The default value is \-8. This option conflicts with +.B \-w +-- the last one given takes effect. .TP -.B \-s \fIprog\fP (\-\-speller=\fIprog\fP) +.B \-s \fIprogram\fP (\-\-speller=\fIprogram\fP) Enable alternative spell checker command. .TP .B \-t (\-\-tempfile) -Always save changed buffer without prompting. Same as Pico's \fB-t\fP +Always save changed buffer without prompting. Same as Pico's \fB\-t\fP option. .TP .B \-u (\-\-undo) -Enable experimental generic-purpose undo code. By default, the undo and redo -shortcuts are Meta-U and Meta-E, respectively. +Enable the experimental generic-purpose undo/redo code. The default undo +and redo shortcuts are Meta-U and Meta-E, respectively. .TP .B \-v (\-\-view) -View file (read only) mode. +View-file (read-only) mode. .TP .B \-w (\-\-nowrap) -Disable wrapping of long lines. +Disable the hard-wrapping of long lines. This option conflicts with +.B \-r +-- the last one given takes effect. .TP .B \-x (\-\-nohelp) -Disable help screen at bottom of editor. +Don't show the two help lines at the bottom of the screen. .TP .B \-z (\-\-suspend) -Enable suspend ability. +Enable the suspend ability. .TP .B \-$ (\-\-softwrap) -Enable 'soft wrapping'. \fBnano\fP will attempt to display the entire -contents of a line, even if it is longer than the screen width. Since +Enable 'soft wrapping'. This will make \fBnano\fP attempt to display the +entire contents of any line, even if it is longer than the screen width, by +continuing it over multiple screen lines. Since \&'$' normally refers to a variable in the Unix shell, you should specify this option last when using other options (e.g. 'nano \-wS$') or pass it separately (e.g. 'nano \-wS \-$'). diff --git a/doc/man/nano.1.html b/doc/man/nano.1.html index 4c385fd0..283c1e02 100644 --- a/doc/man/nano.1.html +++ b/doc/man/nano.1.html @@ -1,5 +1,5 @@ -<!-- Creator : groff version 1.20.1 --> -<!-- CreationDate: Fri Mar 22 10:06:07 2013 --> +<!-- Creator : groff version 1.22.2 --> +<!-- CreationDate: Sat May 10 22:54:14 2014 --> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> @@ -48,22 +48,20 @@ Nano’s ANOther editor, an enhanced free Pico clone</p> <p style="margin-left:11%; margin-top: 1em"><b>nano</b> -<i>[OPTIONS] [[+LINE,COLUMN] FILE]...</i></p> +[<i>options</i>] +[[+<i>line</i>,<i>column</i>] <i>file</i>]...</p> <h2>DESCRIPTION <a name="DESCRIPTION"></a> </h2> -<p style="margin-left:11%; margin-top: 1em">This manual -page briefly documents the <b>nano</b> command.</p> - <p style="margin-left:11%; margin-top: 1em"><b>nano</b> is a small, free and friendly editor which aims to replace Pico, the default editor included in the non-free Pine -package. Rather than just copying Pico’s look and -feel, <b>nano</b> also implements some missing (or disabled -by default) features in Pico, such as "search and +package. On top of copying Pico’s look and feel, +<b>nano</b> also implements some missing (or disabled by +default) features in Pico, such as "search and replace" and "go to line and column number".</p> @@ -73,29 +71,12 @@ number".</p> -<p style="margin-left:11%; margin-top: 1em"><b>+</b><i>LINE</i><b>,</b><i>COLUMN</i></p> - -<p style="margin-left:22%;">Places cursor at line number -<i>LINE</i> and column number <i>COLUMN</i> (at least one of -which must be specified) on startup, instead of the default -of line 1, column 1.</p> - -<table width="100%" border="0" rules="none" frame="void" - cellspacing="0" cellpadding="0"> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="3%"> - - -<p><b>−?</b></p></td> -<td width="8%"></td> -<td width="30%"> +<p style="margin-left:11%; margin-top: 1em"><b>+</b><i>line</i><b>,</b><i>column</i></p> - -<p>Same as <b>-h (−−help)</b>.</p></td> -<td width="48%"> -</td></tr> -</table> +<p style="margin-left:22%;">Places the cursor on line +number <i>line</i> and at column number <i>column</i> (at +least one of which must be specified) on startup, instead of +the default line 1, column 1.</p> <p style="margin-left:11%;"><b>−A (−−smarthome)</b></p> @@ -112,13 +93,13 @@ beginning of the line.</p> <p style="margin-left:22%;">When saving a file, back up the previous version of it to the current filename suffixed with -a ~.</p> +a tilde (<b>~</b>).</p> <p style="margin-left:11%;"><b>−C</b> <i>dir</i> <b>(−−backupdir=</b><i>dir</i><b>)</b></p> <p style="margin-left:22%;">Set the directory where -<b>nano</b> puts unique backup files if file backups are +<b>nano</b> puts unique backup files, if file backups are enabled.</p> <p style="margin-left:11%;"><b>−D @@ -185,6 +166,12 @@ files from DOS/Mac format.</p> <p style="margin-left:22%;">Use the blank line below the titlebar as extra editing space.</p> +<p style="margin-left:11%;"><b>−P +(−−poslog)</b></p> + +<p style="margin-left:22%;">Log and later read back the +location of the cursor and place it there again.</p> + <p style="margin-left:11%;"><b>−Q</b> <i>str</i> <b>(−−quotestr=</b><i>str</i><b>)</b></p> @@ -200,12 +187,13 @@ stands for a Tab.</p> <p style="margin-left:22%;">Restricted mode: don’t read or write to any file not specified on the command line; -read any <i>nanorc</i> files; allow suspending; allow a file -to be appended to, prepended to, or saved under a different -name if it already has one; or use backup files or spell -checking. Also accessible by invoking <b>nano</b> with any -name beginning with ’r’ (e.g. -"rnano").</p> +don’t read any <i>nanorc</i> files; don’t allow +suspending; don’t allow a file to be appended to, +prepended to, or saved under a different name if it already +has one; don’t use backup files nor spell checking. +This restricted mode is also accessible by invoking +<b>nano</b> with any name beginning with ’r’ +(e.g. "rnano").</p> <p style="margin-left:11%;"><b>−S (−−smooth)</b></p> @@ -214,11 +202,11 @@ name beginning with ’r’ (e.g. will scroll line-by-line, instead of the usual chunk-by-chunk behavior.</p> -<p style="margin-left:11%;"><b>−T</b> <i>cols</i> -<b>(−−tabsize=</b><i>cols</i><b>)</b></p> +<p style="margin-left:11%;"><b>−T</b> <i>number</i> +<b>(−−tabsize=</b><i>number</i><b>)</b></p> <p style="margin-left:22%;">Set the size (width) of a tab -to <i>cols</i> columns. The value of <i>cols</i> must be +to <i>number</i> columns. The value of <i>number</i> must be greater than 0. The default value is 8.</p> <p style="margin-left:11%;"><b>−U @@ -226,7 +214,7 @@ greater than 0. The default value is 8.</p> <p style="margin-left:22%;">Do quick statusbar blanking. Statusbar messages will disappear after 1 keystroke instead -of 25. Note that <b>-c</b> overrides this.</p> +of 25. Note that <b>−c</b> overrides this.</p> <p style="margin-left:11%;"><b>−V (−−version)</b></p> @@ -252,7 +240,7 @@ available.</p> (−−const)</b></p> <p style="margin-left:22%;">Constantly show the cursor -position. Note that this overrides <b>-U</b>.</p> +position. Note that this overrides <b>−U</b>.</p> <p style="margin-left:11%;"><b>−d (−−rebinddelete)</b></p> @@ -265,8 +253,8 @@ like Delete on your system.</p> <p style="margin-left:11%;"><b>−h (−−help)</b></p> -<p style="margin-left:22%;">Show a summary of command line -options and exit.</p> +<p style="margin-left:22%;">Show a summary of the available +command-line options and exit.</p> <p style="margin-left:11%;"><b>−i (−−autoindent)</b></p> @@ -278,8 +266,10 @@ source code.</p> <p style="margin-left:11%;"><b>−k (−−cut)</b></p> -<p style="margin-left:22%;">Enable cut from cursor to end -of line.</p> +<p style="margin-left:22%;">Make the ’Cut Text’ +command (normally ^K) cut from the current cursor position +to the end of the line, instead of cutting the entire +line.</p> <p style="margin-left:11%;"><b>−l (−−nofollow)</b></p> @@ -296,7 +286,20 @@ perhaps?</p> available for your system. When enabled, mouse clicks can be used to place the cursor, set the mark (with a double click), and execute shortcuts. The mouse will work in the X -Window System, and on the console when gpm is running.</p> +Window System, and on the console when gpm is running. Text +can still be selected through dragging by holding down the +Shift key.</p> + +<p style="margin-left:11%;"><b>−n +(−−noread)</b></p> + +<p style="margin-left:22%;">Treat any name given on the +command line as a new file. This allows <b>nano</b> to write +to named pipes: it will start with a blank buffer, and will +write to the pipe when the user saves the "file". +This way <b>nano</b> can be used as an editor in combination +with for instance <b>gpg</b> without having to write +sensitive data to disk first.</p> <p style="margin-left:11%;"><b>−o</b> <i>dir</i> <b>(−−operatingdir=</b><i>dir</i><b>)</b></p> @@ -315,21 +318,22 @@ terminal.</p> (−−quiet)</b></p> <p style="margin-left:22%;">Do not report errors in the -<i>nanorc</i> file and ask them to be acknowledged by +<i>nanorc</i> file nor ask them to be acknowledged by pressing Enter at startup.</p> -<p style="margin-left:11%;"><b>−r</b> <i>cols</i> -<b>(−−fill=</b><i>cols</i><b>)</b></p> +<p style="margin-left:11%;"><b>−r</b> <i>number</i> +<b>(−−fill=</b><i>number</i><b>)</b></p> -<p style="margin-left:22%;">Wrap lines at column -<i>cols</i>. If this value is 0 or less, wrapping will occur -at the width of the screen less <i>cols</i> columns, +<p style="margin-left:22%;">Hard-wrap lines at column +<i>number</i>. If this value is 0 or less, wrapping will +occur at the width of the screen less <i>number</i> columns, allowing the wrap point to vary along with the width of the screen if the screen is resized. The default value is -−8.</p> +−8. This option conflicts with <b>−w</b> -- the +last one given takes effect.</p> -<p style="margin-left:11%;"><b>−s</b> <i>prog</i> -<b>(−−speller=</b><i>prog</i><b>)</b></p> +<p style="margin-left:11%;"><b>−s</b> <i>program</i> +<b>(−−speller=</b><i>program</i><b>)</b></p> <p style="margin-left:22%;">Enable alternative spell checker command.</p> @@ -338,45 +342,47 @@ checker command.</p> (−−tempfile)</b></p> <p style="margin-left:22%;">Always save changed buffer -without prompting. Same as Pico’s <b>-t</b> +without prompting. Same as Pico’s <b>−t</b> option.</p> <p style="margin-left:11%;"><b>−u (−−undo)</b></p> -<p style="margin-left:22%;">Enable experimental -generic-purpose undo code. By default, the undo and redo +<p style="margin-left:22%;">Enable the experimental +generic-purpose undo/redo code. The default undo and redo shortcuts are Meta-U and Meta-E, respectively.</p> <p style="margin-left:11%;"><b>−v (−−view)</b></p> -<p style="margin-left:22%;">View file (read only) mode.</p> +<p style="margin-left:22%;">View-file (read-only) mode.</p> <p style="margin-left:11%;"><b>−w (−−nowrap)</b></p> -<p style="margin-left:22%;">Disable wrapping of long -lines.</p> +<p style="margin-left:22%;">Disable the hard-wrapping of +long lines. This option conflicts with <b>−r</b> -- +the last one given takes effect.</p> <p style="margin-left:11%;"><b>−x (−−nohelp)</b></p> -<p style="margin-left:22%;">Disable help screen at bottom -of editor.</p> +<p style="margin-left:22%;">Don’t show the two help +lines at the bottom of the screen.</p> <p style="margin-left:11%;"><b>−z (−−suspend)</b></p> -<p style="margin-left:22%;">Enable suspend ability.</p> +<p style="margin-left:22%;">Enable the suspend ability.</p> <p style="margin-left:11%;"><b>−$ (−−softwrap)</b></p> <p style="margin-left:22%;">Enable ’soft -wrapping’. <b>nano</b> will attempt to display the -entire contents of a line, even if it is longer than the -screen width. Since ’$’ normally refers to a +wrapping’. This will make <b>nano</b> attempt to +display the entire contents of any line, even if it is +longer than the screen width, by continuing it over multiple +screen lines. Since ’$’ normally refers to a variable in the Unix shell, you should specify this option last when using other options (e.g. ’nano −wS$’) or pass it separately (e.g. ’nano diff --git a/doc/man/nanorc.5 b/doc/man/nanorc.5 index 86091da4..deb189ae 100644 --- a/doc/man/nanorc.5 +++ b/doc/man/nanorc.5 @@ -1,6 +1,6 @@ .\" Hey, EMACS: -*- nroff -*- -.\" Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009 -.\" Free Software Foundation, Inc. +.\" Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, +.\" 2013, 2014 Free Software Foundation, Inc. .\" .\" This document is dual-licensed. You may distribute and/or modify it .\" under the terms of either of the following licenses: @@ -18,41 +18,34 @@ .\" Documentation License along with this program. If not, see .\" <http://www.gnu.org/licenses/>. .\" -.\" $Id: nanorc.5 4568 2013-01-21 03:40:08Z astyanax $ -.TH NANORC 5 "version 2.0.0" "August 23, 2007" +.\" $Id: nanorc.5 4852 2014-05-09 21:02:14Z bens $ +.TH NANORC 5 "version 2.3.3" "May 2014" .\" Please adjust this date whenever revising the manpage. .\" .SH NAME nanorc \- GNU nano's rcfile .SH DESCRIPTION -This manual page briefly documents GNU \fBnano\fP's rcfile. -.PP -\fBnano\fP is a small, free and friendly editor which aims to replace -Pico, the default editor included in the non-free Pine package. Rather -than just copying Pico's look and feel, \fBnano\fP also implements some -missing (or disabled by default) features in Pico, such as "search and -replace" and "go to line and column number". -.PP -The \fInanorc\fP file contains the default settings for \fBnano\fP. It -should not be in DOS or Mac format. During startup, \fBnano\fP will -first read its system-wide settings from \fISYSCONFDIR/nanorc\fP, and -then user-specific settings from \fI~/.nanorc\fP. +The \fInanorc\fP file contains the default settings for \fBnano\fP, a +small and friendly editor. The file should be in Unix format, not in +DOS or Mac format. During startup, \fBnano\fP will first read the +system-wide settings, from \fBSYSCONFDIR/nanorc\fP, and then the +user-specific settings, from \fB~/.nanorc\fP. .SH OPTIONS The configuration file accepts a series of \fBset\fP and \fBunset\fP commands, which can be used to configure nano on startup without using -the command line options. Additionally, the \fBsyntax\fP, \fBcolor\fP, -and \fBicolor\fP keywords are used to define syntax highlighting rules -for different text patterns. \fBnano\fP will read one command per line. +command-line options. Additionally, there are some commands to define +syntax highlighting and to rebind keys -- see the two separate sections +on those. \fBnano\fP reads one command per line. Options in \fInanorc\fP files take precedence over nano's defaults, and -command line options override \fInanorc\fP settings. Also, options are +command-line options override \fInanorc\fP settings. Also, options are unset by default, except for those that take arguments. Quotes inside string parameters don't have to be escaped with backslashes. The last double quote in the string will be treated as its -end. For example, for the \fBbrackets\fP option, "\fI"')>]}\fP" will -match \fI"\fP, \fI'\fP, \fI)\fP, \fI>\fP, \fI]\fP, and \fI}\fP. +end. For example, for the \fBbrackets\fP option, "\fB"')>]}\fP" will +match \fB"\fP, \fB'\fP, \fB)\fP, \fB>\fP, \fB]\fP, and \fB}\fP. The supported commands and arguments are: @@ -66,50 +59,62 @@ NOT enable this option unless you are sure you need it. Use auto-indentation. .TP .B set/unset backup -Create backup files in \fIfilename~\fP. +Create backup files by adding a tilde (\fB~\fP) to each file's name. .TP .B set backupdir "\fIdirectory\fP" -Set the directory where \fBnano\fP puts unique backup files if file +Set the directory where \fBnano\fP puts unique backup files, if file backups are enabled. .TP .B set/unset backwards Do backwards searches by default. .TP .B set/unset boldtext -Use bold text instead of reverse video text. +Use bold instead of reverse video for the titlebar, statusbar, key combos, +and selected text. This can be overridden for the first three by setting +the options \fBtitlecolor\fP, \fBstatuscolor\fP, and \fBkeycolor\fP. .TP .B set brackets "\fIstring\fP" Set the characters treated as closing brackets when justifying -paragraphs. They cannot contain blank characters. Only closing -punctuation, optionally followed by closing brackets, can end sentences. -The default value is "\fI"')>]}\fP". +paragraphs. This may not include blank characters. Only closing +punctuation (see \fBpunct\fP), optionally followed by the specified +closing brackets, can end sentences. The default value is "\fB"')>]}\fP". .TP .B set/unset casesensitive -Do case sensitive searches by default. +Do case-sensitive searches by default. .TP .B set/unset const Constantly display the cursor position in the status bar. .TP .B set/unset cut -Use cut to end of line by default. +Use cut-to-end-of-line by default, instead of cutting the whole line. .TP .B set fill \fIn\fP -Wrap lines at column number \fIn\fP. If \fIn\fP is 0 or less, the +Hard-wrap lines at column number \fIn\fP. If \fIn\fP is 0 or less, the maximum line length will be the screen width less \fIn\fP columns. The default value is \-8. .TP +.B set functioncolor \fIfgcolor\fR,\fIbgcolor\fR +Specify the color combination to use for the function descriptions +in the two help lines at the bottom of the screen. +See \fBset titlecolor\fR for more details. +.TP .B set/unset historylog -Enable \fI~/.nano_history\fP for saving and reading search/replace -strings. +Enable the use of \fB~/.nano_history\fP for saving and reading +search/replace strings. +.TP +.B set keycolor \fIfgcolor\fR,\fIbgcolor\fR +Specify the color combination to use for the shortcut key combos +in the two help lines at the bottom of the screen. +See \fBset titlecolor\fR for more details. .TP .B set/unset locking Enable vim-style lock-files for when editing files. .TP .B set matchbrackets "\fIstring\fP" Set the opening and closing brackets that can be found by bracket -searches. They cannot contain blank characters. The former set must -come before the latter set, and both must be in the same order. The -default value is "\fI(<[{)>]}\fP". +searches. This may not include blank characters. The opening set must +come before the closing set, and the two sets must be in the same order. +The default value is "\fB(<[{)>]}\fP". .TP .B set/unset morespace Use the blank line below the titlebar as extra editing space. @@ -118,7 +123,8 @@ Use the blank line below the titlebar as extra editing space. Enable mouse support, if available for your system. When enabled, mouse clicks can be used to place the cursor, set the mark (with a double click), and execute shortcuts. The mouse will work in the X Window -System, and on the console when gpm is running. +System, and on the console when gpm is running. Text can still be +selected through dragging by holding down the Shift key. .TP .B set/unset multibuffer Allow inserting files into their own buffers. @@ -130,13 +136,13 @@ Don't convert files from DOS/Mac format. Don't follow symlinks when writing files. .TP .B set/unset nohelp -Don't display the help lists at the bottom of the screen. +Don't display the two help lines at the bottom of the screen. .TP .B set/unset nonewlines -Don't add newlines to the ends of files. +Don't automatically add a newline to the ends of files. .TP .B set/unset nowrap -Don't wrap text at all. +Don't hard-wrap text at all. .TP .B set operatingdir "\fIdirectory\fP" \fBnano\fP will only read and write files inside \fIdirectory\fP and its @@ -144,30 +150,33 @@ subdirectories. Also, the current directory is changed to here, so files are inserted from this directory. By default, the operating directory feature is turned off. .TP +.B set/unset poslog +Save the cursor position of files between editing sessions. +.TP .B set/unset preserve Preserve the XON and XOFF keys (^Q and ^S). .TP .B set punct "\fIstring\fP" Set the characters treated as closing punctuation when justifying -paragraphs. They cannot contain blank characters. Only closing -punctuation, optionally followed by closing brackets, can end sentences. -The default value is "\fI!.?\fP". -.TP -.B set/unset quiet -\fBnano\fP will not report errors in the \fInanorc\fP file and ask them -to be acknowledged by pressing enter at startup. If this is used it -should be placed at the top of the file to be fully effective. +paragraphs. This may not include blank characters. Only the +specfified closing punctuation, optionally followed by closing brackets +(see \fBbrackets\fP), can end sentences. The default value is "\fB!.?\fP". .TP .B set/unset quickblank Do quick statusbar blanking. Statusbar messages will disappear after 1 keystroke instead of 25. .TP +.B set/unset quiet +\fBnano\fP will not report errors in the \fInanorc\fP file nor ask them +to be acknowledged by pressing Enter at startup. If this is used it +should be placed at the top of the file to be fully effective. +.TP .B set quotestr "\fIstring\fP" The email-quote string, used to justify email-quoted paragraphs. This is an extended regular expression if your system supports them, otherwise a literal string. The default value is -"\fI^([\ \\t]*[#:>\\|}])+\fP" if you have extended regular expression -support, or "\fI>\ \fP" otherwise. Note that '\\t' stands for a literal +"\fB^([\ \\t]*[#:>\\|}])+\fP" if you have extended regular expression +support, and "\fB>\ \fP" otherwise. Note that '\\t' stands for a literal Tab character. .TP .B set/unset rebinddelete @@ -183,9 +192,6 @@ won't work properly with this option enabled. .B set/unset regexp Do extended regular expression searches by default. .TP -.B set/unset poslog -Save the cursor position of files between editing sessions. -.TP .B set/unset smarthome Make the Home key smarter. When Home is pressed anywhere but at the very beginning of non-whitespace characters on a line, the cursor will @@ -203,6 +209,10 @@ Enable soft line wrapping for easier viewing of very long lines. Use spelling checker \fIspellprog\fP instead of the built-in one, which calls \fIspell\fP. .TP +.B set statuscolor \fIfgcolor\fR,\fIbgcolor\fR +Specify the color combination to use for the statusbar. +See \fBset titlecolor\fR for more details. +.TP .B set/unset suspend Allow \fBnano\fP to be suspended. .TP @@ -216,57 +226,76 @@ Convert typed tabs to spaces. .B set/unset tempfile Save automatically on exit, don't prompt. .TP +.B set titlecolor \fIfgcolor\fR,\fIbgcolor\fR +Specify the color combination to use for the titlebar. +Valid color names for foreground and background are: +.BR white , \ black , \ red , \ blue , \ green , \ yellow , \ magenta ", and " cyan . +And either "\fIfgcolor\fR" or ",\fIbgcolor\fR" may be left out. +.TP .B set/unset undo -Enable experimental generic-purpose undo code. +Enable the experimental generic-purpose undo/redo code. .TP .B set/unset view Disallow file modification. .TP -.B set/unset softwrap -Enable soft line wrapping for easier viewing of very long lones. -.TP .B set whitespace "\fIstring\fP" -Set the two characters used to display the first characters of tabs and +Set the two characters used to indicate the presence of tabs and spaces. They must be single-column characters. .TP .B set/unset wordbounds Detect word boundaries more accurately by treating punctuation characters as parts of words. + +.SH SYNTAX HIGHLIGHTING +Coloring the different syntactic elements of a file +can be defined via the following commands: .TP -.B syntax "\fIstr\fP" ["\fIfileregex\fP" ... ] +.BR syntax " ""\fIstr\fR"" [""\fIfileregex\fR"" ...]" Defines a syntax named \fIstr\fP which can be activated via the -\-Y/\-\-syntax command line option, or will be automatically activated if +.BR \-Y / \-\-syntax +command-line option, or will be automatically activated if the current filename matches the extended regular expression \fIfileregex\fP. All following \fBcolor\fP and \fBicolor\fP statements -will apply to \fIsyntax\fP until a new syntax is defined. +will apply to this \fIstr\fP syntax until a new syntax is defined. -The \fInone\fP syntax is reserved; specifying it on the command line is -the same as not having a syntax at all. The \fIdefault\fP syntax is +The \fBnone\fP syntax is reserved; specifying it on the command line is +the same as not having a syntax at all. The \fBdefault\fP syntax is special: it takes no \fIfileregex\fP, and applies to files that don't match any other syntax's \fIfileregex\fP. .TP -.B magic ["\fIregex\fP" ... ] +.BI linter " program " \fR[ "arg " \fR...] +For the currently defined syntax, use the given \fIprogram\fR +to invoke the linter (this overrides the speller function when +defined). +.TP +.BR header " [""\fIregex\fR"" ...] +For the currently defined syntax, add one or more regexes which will +be compared against the very first line of the file to be edited, +to determine whether this syntax should be used for that file. +.TP +.BR magic " [""\fIregex\fR"" ...] For the currently defined syntax, add one or more regexes which -will be compared against the \fBmagic\fP database when attempting -to determine which highlighting rules to use for a given file. This +will be compared against the result of querying the \fBmagic\fP +database about the file to be edited, to determine whether this +syntax should be used for that file. This functionality only works when \fBlibmagic\fP is installed on the system and will be silently ignored otherwise. .TP -.B color \fIfgcolor\fP,\fIbgcolor\fP "\fIregex\fP" ... +.B color \fIfgcolor\fR,\fIbgcolor\fR """\fIregex\fR""" ... For the currently defined syntax, display all expressions matching the extended regular expression \fIregex\fP with foreground color \fIfgcolor\fP and background color \fIbgcolor\fP, at least one of which -must be specified. Legal colors for foreground and background color +must be specified. Valid colors for foreground and background are: white, black, red, blue, green, yellow, magenta, and cyan. You may -use the prefix "bright" to force a stronger color highlight for the +use the prefix "bright" to get a stronger color highlight for the foreground. If your terminal supports transparency, not specifying a \fIbgcolor\fP tells \fBnano\fP to attempt to use a transparent background. .TP -.B icolor \fIfgcolor\fP,\fIbgcolor\fP "\fIregex\fP" ... +.B icolor \fIfgcolor\fR,\fIbgcolor\fR """\fIregex\fR""" ... Same as above, except that the expression matching is case insensitive. .TP -.B color \fIfgcolor\fP,\fIbgcolor\fP start="\fIsr\fP" end="\fIer\fP" +.BR color " \fIfgcolor\fR,\fIbgcolor\fR " start= """\fIsr\fR"" " end= """\fIer\fR"" Display expressions which start with the extended regular expression \fIsr\fP and end with the extended regular expression \fIer\fP with foreground color \fIfgcolor\fP and background color \fIbgcolor\fP, @@ -275,19 +304,35 @@ highlighting to span multiple lines. Note that all subsequent instances of \fIsr\fP after an initial \fIsr\fP is found will be highlighted until the first instance of \fIer\fP. .TP -.B icolor \fIfgcolor\fP,\fIbgcolor\fP start="\fIsr\fP" end="\fIer\fP" +.BR icolor " \fIfgcolor\fR,\fIbgcolor\fR " start= """\fIsr\fR"" " end= """\fIer\fR"" Same as above, except that the expression matching is case insensitive. .TP -.B include "\fIsyntaxfile\fP" +.BR include " ""\fIsyntaxfile\fR""" Read in self-contained color syntaxes from \fIsyntaxfile\fP. Note that -\fIsyntaxfile\fP can only contain \fBsyntax\fP, \fBcolor\fP, and -\fBicolor\fP commands. -.SH KEY BINDINGS +\fIsyntaxfile\fP can only contain the above commands, from \fBsyntax\fP +to \fBicolor\fP. +.TP +.BI extendsyntax " str directive " \fR[ "arg " \fR...] +Extend the syntax previously defined as \fIstr\fP to include +new information. This allows you to add a new \fIcolor\fP, \fIicolor\fP, +\fImagic\fP, \fIheader\fP, or \fIlinter\fP directive to an already +defined syntax -- useful when you want to add to definitions from the +system-installed syntax definitions (which are normally not writable). + +.SH REBINDING KEYS Key bindings may be reassigned via the following commands: .TP -.B bind \fIkey\fP \fIfunction\fP \fImenu\fP +.BI bind " key function menu" Rebinds the key \fIkey\fP to a new function named \fIfunction\fP in the -context of menu \fImenu\fP. The format of \fIkey\fP should be one of: +context of menu \fImenu\fP (or in all menus where the function exists +by using \fBall\fP). +.TP +.BI unbind " key menu" +Unbinds the key \fIkey\fP from the menu named \fImenu\fP (or from all +menus where it exists by using \fBall\fP). + +.TP +The format of \fIkey\fP should be one of: .TP .B ^ followed by an alpha character or the word "Space". @@ -301,218 +346,262 @@ Example: M-C followed by a numeric value from 1 to 16. Example: F10 .TP -Valid function names to be bound include: -.TP 3 + +Valid \fIfunction\fP names to be bound include: + +.TP 2 .B help -Invoke the help menu. +Invokes the help viewer. .TP .B cancel -Cancel the current command. +Cancels the current command. .TP .B exit -Exit from the program. +Exits from the program (or from the help viewer or the file browser). .TP .B writeout -Write the current buffer to disk. -.TP -.B justify -Justify the current text. +Writes the current buffer to disk. .TP .B insert -Insert a file into the current buffer (or into a new buffer when multibuffer +Inserts a file into the current buffer (or into a new buffer when multibuffer is enabled). .TP .B whereis -Search for text in the current buffer. +Searches for text in the current buffer. .TP .B searchagain -Repeat the last search command. -.TP -.B up -Move up in the editor or browser. -.TP -.B down -Move down in the editor or browser. +Repeats the last search command. .TP -.B left -Move left in the editor or browser. -.TP -.B right -Move right in the editor or browser. +.B replace +Interactively replaces text within the current buffer. .TP .B cut -Cut the current line of text and store it. +Cuts and stores the current line (or the marked region). +.TP +.B copytext +Copies the current line (or the marked region) without deleting it. .TP .B uncut -Copy the currently stored text into the current buffer position. +Copies the currently stored text into the current buffer at the +current cursor position. .TP -.B curpos -Show the current line, column, word positions in the file. +.B mark +Sets the mark at the current position, to start selecting text. .TP -.B firstline -Move to the first line of the file. +.B cutrestoffile +Cuts all text from the cursor position till the end of the buffer. .TP -.B lastline -Move to the last line of the file. +.B curpos +Shows the current cursor position: the line, column, and character positions. .TP -.B gotoline -Move to a specific line (and column if specified). +.B wordcount +Counts the number of words, lines and characters in the current buffer. .TP -.B replace -Interactively replace text within the current buffer. +.B speller +Invokes a spell-checking program (or a linting program, if the current +syntax highlighting defines one). .TP -.B mark -Begin selecting text for cutting or pasting at the current position. +.B justify +Justifies the current paragraph. .TP -.B copytext -Copy the currently marked text without deleting it. +.B fulljustify +Justifies the entire current buffer. .TP .B indent -Indent the currently marked text (shift to the right). +Indents (shifts to the right) the currently marked text. .TP .B unindent -Un-indent the currently marked text (shift to the left). +Unindents (shifts to the left) the currently marked text. +.TP +.B left +Goes left one position (in the editor or browser). +.TP +.B right +Goes right one position (in the editor or browser). +.TP +.B up +Goes one line up (in the editor or browser). +.TP +.B down +Goes one line down (in the editor or browser). +.TP +.B scrollup +Scrolls up one line of text from the current position. +.TP +.B scrolldown +Scrolls down one line of text from the current position. .TP .B nextword -Move the cursor to the beginning of the next word. +Moves the cursor to the beginning of the next word. .TP .B prevword -Move the cursor to the beginning of the previous word. +Moves the cursor to the beginning of the previous word. .TP .B home -Move the cursor to the beginning of the current line. +Moves the cursor to the beginning of the current line. .TP .B end -Move the cursor to the end of the current line. +Moves the cursor to the end of the current line. .TP .B beginpara -Move the cursor to the beginning of the current paragraph. +Moves the cursor to the beginning of the current paragraph. .TP .B endpara -Move the cursor to the end of the current paragraph. +Moves the cursor to the end of the current paragraph. .TP -.B findbracket -Move the cursor to the matching bracket (brace, parenthesis, etc.) of the one -under the cursor. +.B prevpage +Goes up one screenful. .TP -.B scrollup -Scroll up one line of text from the current position. +.B nextpage +Goes down one screenful. .TP -.B scrolldown -Scroll down one line of text from the current position. +.B firstline +Goes to the first line of the file. +.TP +.B lastline +Goes to the last line of the file. +.TP +.B gotoline +Goes to a specific line (and column if specified). +.TP +.B findbracket +Moves the cursor to the bracket (brace, parenthesis, etc.) that matches +(pairs) with the one under the cursor. .TP .B prevbuf -Switch to editing/viewing the previous buffer when using multibuffer mode. +Switches to editing/viewing the previous buffer when using multibuffer mode. .TP .B nextbuf -Switch to editing/viewing the next buffer when using multibuffer mode. +Switches to editing/viewing the next buffer when using multibuffer mode. .TP .B verbatim -Insert the next character verbatim into the file. +Inserts the next character verbatim into the file. .TP .B tab -Insert a tab at the current cursor location. +Inserts a tab at the current cursor location. .TP .B enter -Insert a new line below the current one. +Inserts a new line below the current one. .TP .B delete -Delete the character under the cursor. -.TP -.B fulljustify -Justify the entire current file. +Deletes the character under the cursor. .TP -.B wordcount -Count the number of words in the current buffer. -.TP -.B refresh -Refresh the screen. +.B backspace +Deletes the character before the cursor. .TP .B undo -Undo the text action peformed (add text, delete text, etc). +Undoes the last performed text action (add text, delete text, etc). .TP .B redo -Redo the last undone action (i.e., undo an undo). +Redoes the last undone action (i.e., it undoes an undo). +.TP +.B refresh +Refreshes the screen. .TP .B suspend -Suspend the editor (if the suspend function is enabled, see the +Suspends the editor (if the suspending function is enabled, see the "suspendenable" entry below). .TP .B casesens -Toggle case sensitivity in searching (search/replace menus only). +Toggles case sensitivity in searching (search/replace menus only). .TP .B regexp -Toggle whether searching/replacing is based on literal strings or regular expressions. +Toggles whether searching/replacing is based on literal strings or regular expressions. +.TP +.B backwards +Toggles whether searching/replacing goes forward or backward. .TP .B prevhistory -Show the previous history entry in the prompt menus (e.g. search). +Shows the previous history entry in the prompt menus (e.g. search). .TP .B nexthistory -Show the next history entry in the prompt menus (e.g. search). +Shows the next history entry in the prompt menus (e.g. search). .TP .B dontreplace -Switch back to searching instead of replacing. +Switches back to searching instead of replacing. .TP .B gototext -Search for files matching a string in the file browser (reading or writing files). +Searches for files matching a string in the file browser (reading or writing files). .TP .B dosformat -When writing a file, switch to writing a DOS format (CR/LF). +When writing a file, switches to writing a DOS format (CR/LF). .TP .B macformat -When writing a file, switch to writing a Mac format. +When writing a file, switches to writing a Mac format. .TP .B append -When writing a file, append to the end instead of overwriting. +When writing a file, appends to the end instead of overwriting. .TP .B prepend -When writing a file, 'prepend' (write at the beginning) instead of overwriting. +When writing a file, 'prepends' (writes at the beginning) instead of overwriting. .TP .B backup -When writing a file, create a backup of the current file. +When writing a file, creates a backup of the current file. .TP .B firstfile -Move to the first file when using the file browser (reading or writing files). +Goes to the first file when using the file browser (reading or writing files). .TP .B lastfile -Move to the last file when using the file browser (reading or writing files). +Goes to the last file when using the file browser (reading or writing files). .TP .B nohelp -Toggle showing/hiding the two-line list of key bindings at the bottom of the screen. +Toggles the presence of the two-line list of key bindings at the bottom of the screen. .TP .B constupdate -Constantly display the current line, column, word positions. +Toggles the constant display of the current line, column, and character positions. .TP .B morespace -Toggle showing/hiding the blank line which 'separates' the 'title' from the file text. +Toggles the presence of the blank line which 'separates' the titlebar from the file text. .TP .B smoothscroll -Toggle smooth scrolling when moving via the arrow keys. +Toggles smooth scrolling (when moving around with the arrow keys). +.TP +.B softwrap +Toggles the displaying of overlong lines on multiple screen lines. .TP .B whitespacedisplay -Toggle whether whitespace is shown. +Toggles the showing of whitespace. +.TP +.B nosyntax +Toggles syntax highlighting. .TP .B smarthome -Toggle whether the smart home key function is enabled. +Toggles the smartness of the Home key. .TP .B autoindent -Toggle whether new lines will contain the same amount of whitespace as the line above. +Toggles whether new lines will contain the same amount of whitespace as the preceding line. .TP .B cuttoend -Toggle whether cutting text will cut the whole line or just from the current cursor +Toggles whether cutting text will cut the whole line or just from the current cursor position to the end of the line. .TP .B nowrap -Toggle whether long lines will be wrapped to the next line. +Toggles whether long lines will be hard-wrapped to the next line. +.TP +.B tabstospaces +Toggles whether typed tabs will be converted to spaces. +.TP +.B backupfile +Toggles whether a backup will be made of the file to be edited. +.TP +.B multibuffer +Toggles the use of multiple file buffers (if available). +.TP +.B mouse +Toggles mouse support. +.TP +.B noconvert +Toggles automatic conversion of files from DOS/Mac format. .TP .B suspendenable -Toggle whether the suspend sequence (normally ^Z) will suspend the editor window. +Toggles whether the suspend sequence (normally ^Z) will suspend the editor window. .TP -Valid menu sections are: -.TP +Valid \fImenu\fP sections are: + +.TP 2 .B main -The main editor window where text is entered. +The main editor window where text is entered and edited. .TP .B search The search menu (AKA whereis). @@ -533,14 +622,17 @@ The 'write file' menu. The 'insert file' menu. .TP .B extcmd -The menu for inserting output from an external comman, reached from the insert menu. +The menu for inserting output from an external command, reached from the insert menu. .TP .B help -The help menu. +The help-viewer menu. .TP .B spell The interactive spell checker Yes/no menu. .TP +.B linter +The linter menu. +.TP .B browser The file browser for inserting or writing a file. .TP @@ -548,26 +640,19 @@ The file browser for inserting or writing a file. The 'search for a file' menu in the file browser. .TP .B gotodir -The 'go to directory' menu. +The 'go to directory' menu in the file browser. .TP .B all A special name meaning: apply to all menus where this function exists. -.TP -.B unbind \fIkey\fP \fImenu\fP -Unbind the key \fIkey\fP from the menu named \fImenu\fP or from all -menus by using \fIall\fP. Same key syntax as for binding. -Rebinds the key \fIkey\fP to a new function named \fIfunction\fP in the -context of menu \fImenu\fP. The format of \fIkey\fP should be one of: .SH FILES .TP -.I SYSCONFDIR/nanorc +.B SYSCONFDIR/nanorc System-wide configuration file .TP -.I ~/.nanorc +.B ~/.nanorc Per-user configuration file .SH SEE ALSO -.PD 0 .TP \fBnano\fP(1) .PP diff --git a/doc/man/nanorc.5.html b/doc/man/nanorc.5.html index 5a48edd8..90060c14 100644 --- a/doc/man/nanorc.5.html +++ b/doc/man/nanorc.5.html @@ -1,5 +1,5 @@ -<!-- Creator : groff version 1.20.1 --> -<!-- CreationDate: Fri Mar 22 10:06:07 2013 --> +<!-- Creator : groff version 1.22.2 --> +<!-- CreationDate: Sat May 10 22:54:14 2014 --> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> @@ -23,7 +23,8 @@ <a href="#NAME">NAME</a><br> <a href="#DESCRIPTION">DESCRIPTION</a><br> <a href="#OPTIONS">OPTIONS</a><br> -<a href="#KEY BINDINGS">KEY BINDINGS</a><br> +<a href="#SYNTAX HIGHLIGHTING">SYNTAX HIGHLIGHTING</a><br> +<a href="#REBINDING KEYS">REBINDING KEYS</a><br> <a href="#FILES">FILES</a><br> <a href="#SEE ALSO">SEE ALSO</a><br> <a href="#AUTHOR">AUTHOR</a><br> @@ -44,24 +45,13 @@ GNU nano’s rcfile</p> </h2> -<p style="margin-left:11%; margin-top: 1em">This manual -page briefly documents GNU <b>nano</b>’s rcfile.</p> - -<p style="margin-left:11%; margin-top: 1em"><b>nano</b> is -a small, free and friendly editor which aims to replace -Pico, the default editor included in the non-free Pine -package. Rather than just copying Pico’s look and -feel, <b>nano</b> also implements some missing (or disabled -by default) features in Pico, such as "search and -replace" and "go to line and column -number".</p> - <p style="margin-left:11%; margin-top: 1em">The <i>nanorc</i> file contains the default settings for -<b>nano</b>. It should not be in DOS or Mac format. During -startup, <b>nano</b> will first read its system-wide -settings from <i>SYSCONFDIR/nanorc</i>, and then -user-specific settings from <i>~/.nanorc</i>.</p> +<b>nano</b>, a small and friendly editor. The file should be +in Unix format, not in DOS or Mac format. During startup, +<b>nano</b> will first read the system-wide settings, from +<b>SYSCONFDIR/nanorc</b>, and then the user-specific +settings, from <b>~/.nanorc</b>.</p> <h2>OPTIONS <a name="OPTIONS"></a> @@ -71,15 +61,14 @@ user-specific settings from <i>~/.nanorc</i>.</p> <p style="margin-left:11%; margin-top: 1em">The configuration file accepts a series of <b>set</b> and <b>unset</b> commands, which can be used to configure nano -on startup without using the command line options. -Additionally, the <b>syntax</b>, <b>color</b>, and -<b>icolor</b> keywords are used to define syntax -highlighting rules for different text patterns. <b>nano</b> -will read one command per line.</p> +on startup without using command-line options. Additionally, +there are some commands to define syntax highlighting and to +rebind keys -- see the two separate sections on those. +<b>nano</b> reads one command per line.</p> <p style="margin-left:11%; margin-top: 1em">Options in <i>nanorc</i> files take precedence over nano’s -defaults, and command line options override <i>nanorc</i> +defaults, and command-line options override <i>nanorc</i> settings. Also, options are unset by default, except for those that take arguments.</p> @@ -87,9 +76,9 @@ those that take arguments.</p> string parameters don’t have to be escaped with backslashes. The last double quote in the string will be treated as its end. For example, for the <b>brackets</b> -option, "<i>"’)>]}</i>" will match -<i>"</i>, <i>’</i>, <i>)</i>, <i>></i>, -<i>]</i>, and <i>}</i>.</p> +option, "<b>"’)>]}</b>" will match +<b>"</b>, <b>’</b>, <b>)</b>, <b>></b>, +<b>]</b>, and <b>}</b>.</p> <p style="margin-left:11%; margin-top: 1em">The supported commands and arguments are: <b><br> @@ -106,14 +95,14 @@ enable this option unless you are sure you need it.</p> <p style="margin-left:11%;"><b>set/unset backup</b></p> -<p style="margin-left:15%;">Create backup files in -<i>filename~</i>.</p> +<p style="margin-left:15%;">Create backup files by adding a +tilde (<b>~</b>) to each file’s name.</p> <p style="margin-left:11%;"><b>set backupdir</b> <i>directory</i></p> <p style="margin-left:15%;">Set the directory where -<b>nano</b> puts unique backup files if file backups are +<b>nano</b> puts unique backup files, if file backups are enabled.</p> <p style="margin-left:11%;"><b>set/unset backwards</b></p> @@ -123,23 +112,26 @@ default.</p> <p style="margin-left:11%;"><b>set/unset boldtext</b></p> -<p style="margin-left:15%;">Use bold text instead of -reverse video text.</p> +<p style="margin-left:15%;">Use bold instead of reverse +video for the titlebar, statusbar, key combos, and selected +text. This can be overridden for the first three by setting +the options <b>titlecolor</b>, <b>statuscolor</b>, and +<b>keycolor</b>.</p> <p style="margin-left:11%;"><b>set brackets</b> <i>string</i></p> <p style="margin-left:15%;">Set the characters treated as -closing brackets when justifying paragraphs. They cannot -contain blank characters. Only closing punctuation, -optionally followed by closing brackets, can end sentences. -The default value is -"<i>"’)>]}</i>".</p> +closing brackets when justifying paragraphs. This may not +include blank characters. Only closing punctuation (see +<b>punct</b>), optionally followed by the specified closing +brackets, can end sentences. The default value is +"<b>"’)>]}</b>".</p> <p style="margin-left:11%;"><b>set/unset casesensitive</b></p> -<p style="margin-left:15%;">Do case sensitive searches by +<p style="margin-left:15%;">Do case-sensitive searches by default.</p> <p style="margin-left:11%;"><b>set/unset const</b></p> @@ -149,20 +141,37 @@ position in the status bar.</p> <p style="margin-left:11%;"><b>set/unset cut</b></p> -<p style="margin-left:15%;">Use cut to end of line by -default.</p> +<p style="margin-left:15%;">Use cut-to-end-of-line by +default, instead of cutting the whole line.</p> <p style="margin-left:11%;"><b>set fill</b> <i>n</i></p> -<p style="margin-left:15%;">Wrap lines at column number -<i>n</i>. If <i>n</i> is 0 or less, the maximum line length -will be the screen width less <i>n</i> columns. The default -value is −8.</p> +<p style="margin-left:15%;">Hard-wrap lines at column +number <i>n</i>. If <i>n</i> is 0 or less, the maximum line +length will be the screen width less <i>n</i> columns. The +default value is −8.</p> + +<p style="margin-left:11%;"><b>set functioncolor</b> +<i>fgcolor</i>,<i>bgcolor</i></p> + +<p style="margin-left:15%;">Specify the color combination +to use for the function descriptions in the two help lines +at the bottom of the screen. See <b>set titlecolor</b> for +more details.</p> <p style="margin-left:11%;"><b>set/unset historylog</b></p> -<p style="margin-left:15%;">Enable <i>~/.nano_history</i> -for saving and reading search/replace strings.</p> +<p style="margin-left:15%;">Enable the use of +<b>~/.nano_history</b> for saving and reading search/replace +strings.</p> + +<p style="margin-left:11%;"><b>set keycolor</b> +<i>fgcolor</i>,<i>bgcolor</i></p> + +<p style="margin-left:15%;">Specify the color combination +to use for the shortcut key combos in the two help lines at +the bottom of the screen. See <b>set titlecolor</b> for more +details.</p> <p style="margin-left:11%;"><b>set/unset locking</b></p> @@ -173,10 +182,10 @@ when editing files.</p> <i>string</i></p> <p style="margin-left:15%;">Set the opening and closing -brackets that can be found by bracket searches. They cannot -contain blank characters. The former set must come before -the latter set, and both must be in the same order. The -default value is "<i>(<[{)>]}</i>".</p> +brackets that can be found by bracket searches. This may not +include blank characters. The opening set must come before +the closing set, and the two sets must be in the same order. +The default value is "<b>(<[{)>]}</b>".</p> <p style="margin-left:11%;"><b>set/unset morespace</b></p> @@ -189,7 +198,9 @@ titlebar as extra editing space.</p> available for your system. When enabled, mouse clicks can be used to place the cursor, set the mark (with a double click), and execute shortcuts. The mouse will work in the X -Window System, and on the console when gpm is running.</p> +Window System, and on the console when gpm is running. Text +can still be selected through dragging by holding down the +Shift key.</p> <p style="margin-left:11%;"><b>set/unset multibuffer</b></p> @@ -209,17 +220,17 @@ when writing files.</p> <p style="margin-left:11%;"><b>set/unset nohelp</b></p> -<p style="margin-left:15%;">Don’t display the help -lists at the bottom of the screen.</p> +<p style="margin-left:15%;">Don’t display the two +help lines at the bottom of the screen.</p> <p style="margin-left:11%;"><b>set/unset nonewlines</b></p> -<p style="margin-left:15%;">Don’t add newlines to the -ends of files.</p> +<p style="margin-left:15%;">Don’t automatically add a +newline to the ends of files.</p> <p style="margin-left:11%;"><b>set/unset nowrap</b></p> -<p style="margin-left:15%;">Don’t wrap text at +<p style="margin-left:15%;">Don’t hard-wrap text at all.</p> <p style="margin-left:11%;"><b>set operatingdir</b> @@ -231,6 +242,11 @@ Also, the current directory is changed to here, so files are inserted from this directory. By default, the operating directory feature is turned off.</p> +<p style="margin-left:11%;"><b>set/unset poslog</b></p> + +<p style="margin-left:15%;">Save the cursor position of +files between editing sessions.</p> + <p style="margin-left:11%;"><b>set/unset preserve</b></p> <p style="margin-left:15%;">Preserve the XON and XOFF keys @@ -240,18 +256,11 @@ directory feature is turned off.</p> <i>string</i></p> <p style="margin-left:15%;">Set the characters treated as -closing punctuation when justifying paragraphs. They cannot -contain blank characters. Only closing punctuation, -optionally followed by closing brackets, can end sentences. -The default value is "<i>!.?</i>".</p> - -<p style="margin-left:11%;"><b>set/unset quiet</b></p> - -<p style="margin-left:15%;"><b>nano</b> will not report -errors in the <i>nanorc</i> file and ask them to be -acknowledged by pressing enter at startup. If this is used -it should be placed at the top of the file to be fully -effective.</p> +closing punctuation when justifying paragraphs. This may not +include blank characters. Only the specfified closing +punctuation, optionally followed by closing brackets (see +<b>brackets</b>), can end sentences. The default value is +"<b>!.?</b>".</p> <p style="margin-left:11%;"><b>set/unset quickblank</b></p> @@ -259,6 +268,14 @@ effective.</p> Statusbar messages will disappear after 1 keystroke instead of 25.</p> +<p style="margin-left:11%;"><b>set/unset quiet</b></p> + +<p style="margin-left:15%;"><b>nano</b> will not report +errors in the <i>nanorc</i> file nor ask them to be +acknowledged by pressing Enter at startup. If this is used +it should be placed at the top of the file to be fully +effective.</p> + <p style="margin-left:11%;"><b>set quotestr</b> <i>string</i></p> @@ -266,9 +283,9 @@ of 25.</p> justify email-quoted paragraphs. This is an extended regular expression if your system supports them, otherwise a literal string. The default value is -"<i>^([ \t]*[#:>\|}])+</i>" if you have -extended regular expression support, or -"<i>> </i>" otherwise. Note that +"<b>^([ \t]*[#:>\|}])+</b>" if you have +extended regular expression support, and +"<b>> </b>" otherwise. Note that ’\t’ stands for a literal Tab character.</p> <p style="margin-left:11%;"><b>set/unset @@ -292,11 +309,6 @@ won’t work properly with this option enabled.</p> <p style="margin-left:15%;">Do extended regular expression searches by default.</p> -<p style="margin-left:11%;"><b>set/unset poslog</b></p> - -<p style="margin-left:15%;">Save the cursor position of -files between editing sessions.</p> - <p style="margin-left:11%;"><b>set/unset smarthome</b></p> <p style="margin-left:15%;">Make the Home key smarter. When @@ -323,6 +335,13 @@ easier viewing of very long lines.</p> <i>spellprog</i> instead of the built-in one, which calls <i>spell</i>.</p> +<p style="margin-left:11%;"><b>set statuscolor</b> +<i>fgcolor</i>,<i>bgcolor</i></p> + +<p style="margin-left:15%;">Specify the color combination +to use for the statusbar. See <b>set titlecolor</b> for more +details.</p> + <p style="margin-left:11%;"><b>set/unset suspend</b></p> <p style="margin-left:15%;">Allow <b>nano</b> to be @@ -345,26 +364,31 @@ spaces.</p> <p style="margin-left:15%;">Save automatically on exit, don’t prompt.</p> +<p style="margin-left:11%;"><b>set titlecolor</b> +<i>fgcolor</i>,<i>bgcolor</i></p> + +<p style="margin-left:15%;">Specify the color combination +to use for the titlebar. Valid color names for foreground +and background are: +<b>white</b>, <b>black</b>, <b>red</b>, <b>blue</b>, <b>green</b>, <b>yellow</b>, <b>magenta</b>, +and <b>cyan</b>. And either "<i>fgcolor</i>" or +",<i>bgcolor</i>" may be left out.</p> + <p style="margin-left:11%;"><b>set/unset undo</b></p> -<p style="margin-left:15%;">Enable experimental -generic-purpose undo code.</p> +<p style="margin-left:15%;">Enable the experimental +generic-purpose undo/redo code.</p> <p style="margin-left:11%;"><b>set/unset view</b></p> <p style="margin-left:15%;">Disallow file modification.</p> -<p style="margin-left:11%;"><b>set/unset softwrap</b></p> - -<p style="margin-left:15%;">Enable soft line wrapping for -easier viewing of very long lones.</p> - <p style="margin-left:11%;"><b>set whitespace</b> <i>string</i></p> <p style="margin-left:15%;">Set the two characters used to -display the first characters of tabs and spaces. They must -be single-column characters.</p> +indicate the presence of tabs and spaces. They must be +single-column characters.</p> <p style="margin-left:11%;"><b>set/unset wordbounds</b></p> @@ -372,62 +396,89 @@ be single-column characters.</p> accurately by treating punctuation characters as parts of words.</p> -<p style="margin-left:11%;"><b>syntax</b> <i>str</i> -<b>["</b><i>fileregex</i><b>" ... ]</b></p> +<h2>SYNTAX HIGHLIGHTING +<a name="SYNTAX HIGHLIGHTING"></a> +</h2> -<p style="margin-left:15%;">Defines a syntax named -<i>str</i> which can be activated via the -−Y/−−syntax command line option, or will -be automatically activated if the current filename matches -the extended regular expression <i>fileregex</i>. All -following <b>color</b> and <b>icolor</b> statements will -apply to <i>syntax</i> until a new syntax is defined.</p> -<p style="margin-left:15%; margin-top: 1em">The <i>none</i> +<p style="margin-left:11%; margin-top: 1em">Coloring the +different syntactic elements of a file can be defined via +the following commands: <b><br> +syntax</b> "<i>str</i>" +["<i>fileregex</i>" ...]</p> + +<p style="margin-left:22%;">Defines a syntax named +<i>str</i> which can be activated via the +<b>−Y</b>/<b>−−syntax</b> command-line +option, or will be automatically activated if the current +filename matches the extended regular expression +<i>fileregex</i>. All following <b>color</b> and +<b>icolor</b> statements will apply to this <i>str</i> +syntax until a new syntax is defined.</p> + +<p style="margin-left:22%; margin-top: 1em">The <b>none</b> syntax is reserved; specifying it on the command line is the -same as not having a syntax at all. The <i>default</i> +same as not having a syntax at all. The <b>default</b> syntax is special: it takes no <i>fileregex</i>, and applies to files that don’t match any other syntax’s <i>fileregex</i>.</p> -<p style="margin-left:11%;"><b>magic -["</b><i>regex</i><b>" ... ]</b></p> +<p style="margin-left:11%;"><b>linter</b> <i>program</i> +[<i>arg</i> ...]</p> -<p style="margin-left:15%;">For the currently defined +<p style="margin-left:22%;">For the currently defined +syntax, use the given <i>program</i> to invoke the linter +(this overrides the speller function when defined).</p> + +<p style="margin-left:11%;"><b>header</b> +["<i>regex</i>" ...]</p> + +<p style="margin-left:22%;">For the currently defined +syntax, add one or more regexes which will be compared +against the very first line of the file to be edited, to +determine whether this syntax should be used for that +file.</p> + +<p style="margin-left:11%;"><b>magic</b> +["<i>regex</i>" ...]</p> + +<p style="margin-left:22%;">For the currently defined syntax, add one or more regexes which will be compared -against the <b>magic</b> database when attempting to -determine which highlighting rules to use for a given file. -This functionality only works when <b>libmagic</b> is -installed on the system and will be silently ignored -otherwise.</p> +against the result of querying the <b>magic</b> database +about the file to be edited, to determine whether this +syntax should be used for that file. This functionality only +works when <b>libmagic</b> is installed on the system and +will be silently ignored otherwise.</p> <p style="margin-left:11%;"><b>color</b> -<i>fgcolor</i><b>,</b><i>bgcolor regex</i> <b>...</b></p> +<i>fgcolor</i>,<i>bgcolor</i> "<i>regex</i>" +...</p> -<p style="margin-left:15%;">For the currently defined +<p style="margin-left:22%;">For the currently defined syntax, display all expressions matching the extended regular expression <i>regex</i> with foreground color <i>fgcolor</i> and background color <i>bgcolor</i>, at least -one of which must be specified. Legal colors for foreground -and background color are: white, black, red, blue, green, -yellow, magenta, and cyan. You may use the prefix -"bright" to force a stronger color highlight for -the foreground. If your terminal supports transparency, not -specifying a <i>bgcolor</i> tells <b>nano</b> to attempt to -use a transparent background.</p> +one of which must be specified. Valid colors for foreground +and background are: white, black, red, blue, green, yellow, +magenta, and cyan. You may use the prefix "bright" +to get a stronger color highlight for the foreground. If +your terminal supports transparency, not specifying a +<i>bgcolor</i> tells <b>nano</b> to attempt to use a +transparent background.</p> <p style="margin-left:11%;"><b>icolor</b> -<i>fgcolor</i><b>,</b><i>bgcolor regex</i> <b>...</b></p> +<i>fgcolor</i>,<i>bgcolor</i> "<i>regex</i>" +...</p> -<p style="margin-left:15%;">Same as above, except that the +<p style="margin-left:22%;">Same as above, except that the expression matching is case insensitive.</p> <p style="margin-left:11%;"><b>color</b> -<i>fgcolor</i><b>,</b><i>bgcolor</i> -<b>start="</b><i>sr</i><b>" -end="</b><i>er</i><b>"</b></p> +<i>fgcolor</i>,<i>bgcolor</i> +<b>start=</b>"<i>sr</i>" +<b>end=</b>"<i>er</i>"</p> -<p style="margin-left:15%;">Display expressions which start +<p style="margin-left:22%;">Display expressions which start with the extended regular expression <i>sr</i> and end with the extended regular expression <i>er</i> with foreground color <i>fgcolor</i> and background color <i>bgcolor</i>, at @@ -438,23 +489,34 @@ is found will be highlighted until the first instance of <i>er</i>.</p> <p style="margin-left:11%;"><b>icolor</b> -<i>fgcolor</i><b>,</b><i>bgcolor</i> -<b>start="</b><i>sr</i><b>" -end="</b><i>er</i><b>"</b></p> +<i>fgcolor</i>,<i>bgcolor</i> +<b>start=</b>"<i>sr</i>" +<b>end=</b>"<i>er</i>"</p> -<p style="margin-left:15%;">Same as above, except that the +<p style="margin-left:22%;">Same as above, except that the expression matching is case insensitive.</p> <p style="margin-left:11%;"><b>include</b> -<i>syntaxfile</i></p> +"<i>syntaxfile</i>"</p> -<p style="margin-left:15%;">Read in self-contained color +<p style="margin-left:22%;">Read in self-contained color syntaxes from <i>syntaxfile</i>. Note that <i>syntaxfile</i> -can only contain <b>syntax</b>, <b>color</b>, and -<b>icolor</b> commands.</p> - -<h2>KEY BINDINGS -<a name="KEY BINDINGS"></a> +can only contain the above commands, from <b>syntax</b> to +<b>icolor</b>.</p> + +<p style="margin-left:11%;"><b>extendsyntax</b> <i>str +directive</i> [<i>arg</i> ...]</p> + +<p style="margin-left:22%;">Extend the syntax previously +defined as <i>str</i> to include new information. This +allows you to add a new <i>color</i>, <i>icolor</i>, +<i>magic</i>, <i>header</i>, or <i>linter</i> directive to +an already defined syntax -- useful when you want to add to +definitions from the system-installed syntax definitions +(which are normally not writable).</p> + +<h2>REBINDING KEYS +<a name="REBINDING KEYS"></a> </h2> @@ -464,7 +526,18 @@ bind</b> <i>key function menu</i></p> <p style="margin-left:22%;">Rebinds the key <i>key</i> to a new function named <i>function</i> in the context of menu -<i>menu</i>. The format of <i>key</i> should be one of:</p> +<i>menu</i> (or in all menus where the function exists by +using <b>all</b>).</p> + +<p style="margin-left:11%;"><b>unbind</b> <i>key +menu</i></p> + +<p style="margin-left:22%;">Unbinds the key <i>key</i> from +the menu named <i>menu</i> (or from all menus where it +exists by using <b>all</b>).</p> + +<p style="margin-left:11%;">The format of <i>key</i> should +be one of:</p> <table width="100%" border="0" rules="none" frame="void" cellspacing="0" cellpadding="0"> @@ -506,452 +579,502 @@ new function named <i>function</i> in the context of menu F10</p> </td></tr> </table> -<p style="margin-left:11%;">Valid function names to be -bound include: <b><br> +<p style="margin-left:11%; margin-top: 1em">Valid +<i>function</i> names to be bound include: <b><br> help</b></p> -<p style="margin-left:15%;">Invoke the help menu.</p> +<p style="margin-left:14%;">Invokes the help viewer.</p> <p style="margin-left:11%;"><b>cancel</b></p> -<p style="margin-left:15%;">Cancel the current command.</p> +<p style="margin-left:14%;">Cancels the current +command.</p> <p style="margin-left:11%;"><b>exit</b></p> -<p style="margin-left:15%;">Exit from the program.</p> +<p style="margin-left:14%;">Exits from the program (or from +the help viewer or the file browser).</p> <p style="margin-left:11%;"><b>writeout</b></p> -<p style="margin-left:15%;">Write the current buffer to +<p style="margin-left:14%;">Writes the current buffer to disk.</p> -<p style="margin-left:11%;"><b>justify</b></p> - -<p style="margin-left:15%;">Justify the current text.</p> - <p style="margin-left:11%;"><b>insert</b></p> -<p style="margin-left:15%;">Insert a file into the current +<p style="margin-left:14%;">Inserts a file into the current buffer (or into a new buffer when multibuffer is enabled).</p> <p style="margin-left:11%;"><b>whereis</b></p> -<p style="margin-left:15%;">Search for text in the current -buffer.</p> +<p style="margin-left:14%;">Searches for text in the +current buffer.</p> <p style="margin-left:11%;"><b>searchagain</b></p> -<p style="margin-left:15%;">Repeat the last search +<p style="margin-left:14%;">Repeats the last search command.</p> -<table width="100%" border="0" rules="none" frame="void" - cellspacing="0" cellpadding="0"> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="3%"> +<p style="margin-left:11%;"><b>replace</b></p> +<p style="margin-left:14%;">Interactively replaces text +within the current buffer.</p> -<p><b>up</b></p></td> -<td width="1%"></td> -<td width="51%"> +<p style="margin-left:11%;"><b>cut</b></p> +<p style="margin-left:14%;">Cuts and stores the current +line (or the marked region).</p> -<p>Move up in the editor or browser.</p></td> -<td width="34%"> -</td></tr> -</table> +<p style="margin-left:11%;"><b>copytext</b></p> -<p style="margin-left:11%;"><b>down</b></p> +<p style="margin-left:14%;">Copies the current line (or the +marked region) without deleting it.</p> -<p style="margin-left:15%;">Move down in the editor or -browser.</p> +<p style="margin-left:11%;"><b>uncut</b></p> -<p style="margin-left:11%;"><b>left</b></p> +<p style="margin-left:14%;">Copies the currently stored +text into the current buffer at the current cursor +position.</p> -<p style="margin-left:15%;">Move left in the editor or -browser.</p> +<p style="margin-left:11%;"><b>mark</b></p> -<p style="margin-left:11%;"><b>right</b></p> +<p style="margin-left:14%;">Sets the mark at the current +position, to start selecting text.</p> -<p style="margin-left:15%;">Move right in the editor or -browser.</p> +<p style="margin-left:11%;"><b>cutrestoffile</b></p> -<p style="margin-left:11%;"><b>cut</b></p> +<p style="margin-left:14%;">Cuts all text from the cursor +position till the end of the buffer.</p> -<p style="margin-left:15%;">Cut the current line of text -and store it.</p> +<p style="margin-left:11%;"><b>curpos</b></p> -<p style="margin-left:11%;"><b>uncut</b></p> +<p style="margin-left:14%;">Shows the current cursor +position: the line, column, and character positions.</p> -<p style="margin-left:15%;">Copy the currently stored text -into the current buffer position.</p> +<p style="margin-left:11%;"><b>wordcount</b></p> -<p style="margin-left:11%;"><b>curpos</b></p> +<p style="margin-left:14%;">Counts the number of words, +lines and characters in the current buffer.</p> -<p style="margin-left:15%;">Show the current line, column, -word positions in the file.</p> +<p style="margin-left:11%;"><b>speller</b></p> -<p style="margin-left:11%;"><b>firstline</b></p> +<p style="margin-left:14%;">Invokes a spell-checking +program (or a linting program, if the current syntax +highlighting defines one).</p> -<p style="margin-left:15%;">Move to the first line of the -file.</p> +<p style="margin-left:11%;"><b>justify</b></p> -<p style="margin-left:11%;"><b>lastline</b></p> +<p style="margin-left:14%;">Justifies the current +paragraph.</p> -<p style="margin-left:15%;">Move to the last line of the -file.</p> +<p style="margin-left:11%;"><b>fulljustify</b></p> -<p style="margin-left:11%;"><b>gotoline</b></p> +<p style="margin-left:14%;">Justifies the entire current +buffer.</p> -<p style="margin-left:15%;">Move to a specific line (and -column if specified).</p> +<p style="margin-left:11%;"><b>indent</b></p> -<p style="margin-left:11%;"><b>replace</b></p> +<p style="margin-left:14%;">Indents (shifts to the right) +the currently marked text.</p> -<p style="margin-left:15%;">Interactively replace text -within the current buffer.</p> +<p style="margin-left:11%;"><b>unindent</b></p> -<p style="margin-left:11%;"><b>mark</b></p> +<p style="margin-left:14%;">Unindents (shifts to the left) +the currently marked text.</p> -<p style="margin-left:15%;">Begin selecting text for -cutting or pasting at the current position.</p> +<p style="margin-left:11%;"><b>left</b></p> -<p style="margin-left:11%;"><b>copytext</b></p> +<p style="margin-left:14%;">Goes left one position (in the +editor or browser).</p> -<p style="margin-left:15%;">Copy the currently marked text -without deleting it.</p> +<p style="margin-left:11%;"><b>right</b></p> -<p style="margin-left:11%;"><b>indent</b></p> +<p style="margin-left:14%;">Goes right one position (in the +editor or browser).</p> -<p style="margin-left:15%;">Indent the currently marked -text (shift to the right).</p> +<p style="margin-left:11%;"><b>up</b></p> -<p style="margin-left:11%;"><b>unindent</b></p> +<p style="margin-left:14%;">Goes one line up (in the editor +or browser).</p> -<p style="margin-left:15%;">Un-indent the currently marked -text (shift to the left).</p> +<p style="margin-left:11%;"><b>down</b></p> + +<p style="margin-left:14%;">Goes one line down (in the +editor or browser).</p> + +<p style="margin-left:11%;"><b>scrollup</b></p> + +<p style="margin-left:14%;">Scrolls up one line of text +from the current position.</p> + +<p style="margin-left:11%;"><b>scrolldown</b></p> + +<p style="margin-left:14%;">Scrolls down one line of text +from the current position.</p> <p style="margin-left:11%;"><b>nextword</b></p> -<p style="margin-left:15%;">Move the cursor to the +<p style="margin-left:14%;">Moves the cursor to the beginning of the next word.</p> <p style="margin-left:11%;"><b>prevword</b></p> -<p style="margin-left:15%;">Move the cursor to the +<p style="margin-left:14%;">Moves the cursor to the beginning of the previous word.</p> <p style="margin-left:11%;"><b>home</b></p> -<p style="margin-left:15%;">Move the cursor to the +<p style="margin-left:14%;">Moves the cursor to the beginning of the current line.</p> <p style="margin-left:11%;"><b>end</b></p> -<p style="margin-left:15%;">Move the cursor to the end of +<p style="margin-left:14%;">Moves the cursor to the end of the current line.</p> <p style="margin-left:11%;"><b>beginpara</b></p> -<p style="margin-left:15%;">Move the cursor to the +<p style="margin-left:14%;">Moves the cursor to the beginning of the current paragraph.</p> <p style="margin-left:11%;"><b>endpara</b></p> -<p style="margin-left:15%;">Move the cursor to the end of +<p style="margin-left:14%;">Moves the cursor to the end of the current paragraph.</p> -<p style="margin-left:11%;"><b>findbracket</b></p> +<p style="margin-left:11%;"><b>prevpage</b></p> -<p style="margin-left:15%;">Move the cursor to the matching -bracket (brace, parenthesis, etc.) of the one under the -cursor.</p> +<p style="margin-left:14%;">Goes up one screenful.</p> -<p style="margin-left:11%;"><b>scrollup</b></p> +<p style="margin-left:11%;"><b>nextpage</b></p> -<p style="margin-left:15%;">Scroll up one line of text from -the current position.</p> +<p style="margin-left:14%;">Goes down one screenful.</p> -<p style="margin-left:11%;"><b>scrolldown</b></p> +<p style="margin-left:11%;"><b>firstline</b></p> -<p style="margin-left:15%;">Scroll down one line of text -from the current position.</p> +<p style="margin-left:14%;">Goes to the first line of the +file.</p> + +<p style="margin-left:11%;"><b>lastline</b></p> + +<p style="margin-left:14%;">Goes to the last line of the +file.</p> + +<p style="margin-left:11%;"><b>gotoline</b></p> + +<p style="margin-left:14%;">Goes to a specific line (and +column if specified).</p> + +<p style="margin-left:11%;"><b>findbracket</b></p> + +<p style="margin-left:14%;">Moves the cursor to the bracket +(brace, parenthesis, etc.) that matches (pairs) with the one +under the cursor.</p> <p style="margin-left:11%;"><b>prevbuf</b></p> -<p style="margin-left:15%;">Switch to editing/viewing the +<p style="margin-left:14%;">Switches to editing/viewing the previous buffer when using multibuffer mode.</p> <p style="margin-left:11%;"><b>nextbuf</b></p> -<p style="margin-left:15%;">Switch to editing/viewing the +<p style="margin-left:14%;">Switches to editing/viewing the next buffer when using multibuffer mode.</p> <p style="margin-left:11%;"><b>verbatim</b></p> -<p style="margin-left:15%;">Insert the next character +<p style="margin-left:14%;">Inserts the next character verbatim into the file.</p> <p style="margin-left:11%;"><b>tab</b></p> -<p style="margin-left:15%;">Insert a tab at the current +<p style="margin-left:14%;">Inserts a tab at the current cursor location.</p> <p style="margin-left:11%;"><b>enter</b></p> -<p style="margin-left:15%;">Insert a new line below the +<p style="margin-left:14%;">Inserts a new line below the current one.</p> <p style="margin-left:11%;"><b>delete</b></p> -<p style="margin-left:15%;">Delete the character under the +<p style="margin-left:14%;">Deletes the character under the cursor.</p> -<p style="margin-left:11%;"><b>fulljustify</b></p> - -<p style="margin-left:15%;">Justify the entire current -file.</p> - -<p style="margin-left:11%;"><b>wordcount</b></p> - -<p style="margin-left:15%;">Count the number of words in -the current buffer.</p> - -<p style="margin-left:11%;"><b>refresh</b></p> +<p style="margin-left:11%;"><b>backspace</b></p> -<p style="margin-left:15%;">Refresh the screen.</p> +<p style="margin-left:14%;">Deletes the character before +the cursor.</p> <p style="margin-left:11%;"><b>undo</b></p> -<p style="margin-left:15%;">Undo the text action peformed -(add text, delete text, etc).</p> +<p style="margin-left:14%;">Undoes the last performed text +action (add text, delete text, etc).</p> <p style="margin-left:11%;"><b>redo</b></p> -<p style="margin-left:15%;">Redo the last undone action -(i.e., undo an undo).</p> +<p style="margin-left:14%;">Redoes the last undone action +(i.e., it undoes an undo).</p> + +<p style="margin-left:11%;"><b>refresh</b></p> + +<p style="margin-left:14%;">Refreshes the screen.</p> <p style="margin-left:11%;"><b>suspend</b></p> -<p style="margin-left:15%;">Suspend the editor (if the -suspend function is enabled, see the +<p style="margin-left:14%;">Suspends the editor (if the +suspending function is enabled, see the "suspendenable" entry below).</p> <p style="margin-left:11%;"><b>casesens</b></p> -<p style="margin-left:15%;">Toggle case sensitivity in +<p style="margin-left:14%;">Toggles case sensitivity in searching (search/replace menus only).</p> <p style="margin-left:11%;"><b>regexp</b></p> -<p style="margin-left:15%;">Toggle whether +<p style="margin-left:14%;">Toggles whether searching/replacing is based on literal strings or regular expressions.</p> +<p style="margin-left:11%;"><b>backwards</b></p> + +<p style="margin-left:14%;">Toggles whether +searching/replacing goes forward or backward.</p> + <p style="margin-left:11%;"><b>prevhistory</b></p> -<p style="margin-left:15%;">Show the previous history entry -in the prompt menus (e.g. search).</p> +<p style="margin-left:14%;">Shows the previous history +entry in the prompt menus (e.g. search).</p> <p style="margin-left:11%;"><b>nexthistory</b></p> -<p style="margin-left:15%;">Show the next history entry in +<p style="margin-left:14%;">Shows the next history entry in the prompt menus (e.g. search).</p> <p style="margin-left:11%;"><b>dontreplace</b></p> -<p style="margin-left:15%;">Switch back to searching +<p style="margin-left:14%;">Switches back to searching instead of replacing.</p> <p style="margin-left:11%;"><b>gototext</b></p> -<p style="margin-left:15%;">Search for files matching a +<p style="margin-left:14%;">Searches for files matching a string in the file browser (reading or writing files).</p> <p style="margin-left:11%;"><b>dosformat</b></p> -<p style="margin-left:15%;">When writing a file, switch to -writing a DOS format (CR/LF).</p> +<p style="margin-left:14%;">When writing a file, switches +to writing a DOS format (CR/LF).</p> <p style="margin-left:11%;"><b>macformat</b></p> -<p style="margin-left:15%;">When writing a file, switch to -writing a Mac format.</p> +<p style="margin-left:14%;">When writing a file, switches +to writing a Mac format.</p> <p style="margin-left:11%;"><b>append</b></p> -<p style="margin-left:15%;">When writing a file, append to +<p style="margin-left:14%;">When writing a file, appends to the end instead of overwriting.</p> <p style="margin-left:11%;"><b>prepend</b></p> -<p style="margin-left:15%;">When writing a file, -’prepend’ (write at the beginning) instead of +<p style="margin-left:14%;">When writing a file, +’prepends’ (writes at the beginning) instead of overwriting.</p> <p style="margin-left:11%;"><b>backup</b></p> -<p style="margin-left:15%;">When writing a file, create a +<p style="margin-left:14%;">When writing a file, creates a backup of the current file.</p> <p style="margin-left:11%;"><b>firstfile</b></p> -<p style="margin-left:15%;">Move to the first file when +<p style="margin-left:14%;">Goes to the first file when using the file browser (reading or writing files).</p> <p style="margin-left:11%;"><b>lastfile</b></p> -<p style="margin-left:15%;">Move to the last file when +<p style="margin-left:14%;">Goes to the last file when using the file browser (reading or writing files).</p> <p style="margin-left:11%;"><b>nohelp</b></p> -<p style="margin-left:15%;">Toggle showing/hiding the +<p style="margin-left:14%;">Toggles the presence of the two-line list of key bindings at the bottom of the screen.</p> <p style="margin-left:11%;"><b>constupdate</b></p> -<p style="margin-left:15%;">Constantly display the current -line, column, word positions.</p> +<p style="margin-left:14%;">Toggles the constant display of +the current line, column, and character positions.</p> <p style="margin-left:11%;"><b>morespace</b></p> -<p style="margin-left:15%;">Toggle showing/hiding the blank -line which ’separates’ the ’title’ -from the file text.</p> +<p style="margin-left:14%;">Toggles the presence of the +blank line which ’separates’ the titlebar from +the file text.</p> <p style="margin-left:11%;"><b>smoothscroll</b></p> -<p style="margin-left:15%;">Toggle smooth scrolling when -moving via the arrow keys.</p> +<p style="margin-left:14%;">Toggles smooth scrolling (when +moving around with the arrow keys).</p> + +<p style="margin-left:11%;"><b>softwrap</b></p> + +<p style="margin-left:14%;">Toggles the displaying of +overlong lines on multiple screen lines.</p> <p style="margin-left:11%;"><b>whitespacedisplay</b></p> -<p style="margin-left:15%;">Toggle whether whitespace is -shown.</p> +<p style="margin-left:14%;">Toggles the showing of +whitespace.</p> + +<p style="margin-left:11%;"><b>nosyntax</b></p> + +<p style="margin-left:14%;">Toggles syntax +highlighting.</p> <p style="margin-left:11%;"><b>smarthome</b></p> -<p style="margin-left:15%;">Toggle whether the smart home -key function is enabled.</p> +<p style="margin-left:14%;">Toggles the smartness of the +Home key.</p> <p style="margin-left:11%;"><b>autoindent</b></p> -<p style="margin-left:15%;">Toggle whether new lines will -contain the same amount of whitespace as the line above.</p> +<p style="margin-left:14%;">Toggles whether new lines will +contain the same amount of whitespace as the preceding +line.</p> <p style="margin-left:11%;"><b>cuttoend</b></p> -<p style="margin-left:15%;">Toggle whether cutting text +<p style="margin-left:14%;">Toggles whether cutting text will cut the whole line or just from the current cursor position to the end of the line.</p> <p style="margin-left:11%;"><b>nowrap</b></p> -<p style="margin-left:15%;">Toggle whether long lines will -be wrapped to the next line.</p> +<p style="margin-left:14%;">Toggles whether long lines will +be hard-wrapped to the next line.</p> + +<p style="margin-left:11%;"><b>tabstospaces</b></p> + +<p style="margin-left:14%;">Toggles whether typed tabs will +be converted to spaces.</p> + +<p style="margin-left:11%;"><b>backupfile</b></p> + +<p style="margin-left:14%;">Toggles whether a backup will +be made of the file to be edited.</p> + +<p style="margin-left:11%;"><b>multibuffer</b></p> + +<p style="margin-left:14%;">Toggles the use of multiple +file buffers (if available).</p> + +<p style="margin-left:11%;"><b>mouse</b></p> + +<p style="margin-left:14%;">Toggles mouse support.</p> + +<p style="margin-left:11%;"><b>noconvert</b></p> + +<p style="margin-left:14%;">Toggles automatic conversion of +files from DOS/Mac format.</p> <p style="margin-left:11%;"><b>suspendenable</b></p> -<p style="margin-left:15%;">Toggle whether the suspend +<p style="margin-left:14%;">Toggles whether the suspend sequence (normally ^Z) will suspend the editor window.</p> -<p style="margin-left:11%; margin-top: 1em">Valid menu -sections are: <b><br> +<p style="margin-left:11%; margin-top: 1em">Valid +<i>menu</i> sections are: <b><br> main</b></p> -<p style="margin-left:15%;">The main editor window where -text is entered.</p> +<p style="margin-left:14%;">The main editor window where +text is entered and edited.</p> <p style="margin-left:11%;"><b>search</b></p> -<p style="margin-left:15%;">The search menu (AKA +<p style="margin-left:14%;">The search menu (AKA whereis).</p> <p style="margin-left:11%;"><b>replace</b></p> -<p style="margin-left:15%;">The ’search to +<p style="margin-left:14%;">The ’search to replace’ menu.</p> <p style="margin-left:11%;"><b>replacewith</b></p> -<p style="margin-left:15%;">The ’replace with’ +<p style="margin-left:14%;">The ’replace with’ menu, which comes up after ’search to replace’.</p> <p style="margin-left:11%;"><b>gotoline</b></p> -<p style="margin-left:15%;">The ’goto line (and +<p style="margin-left:14%;">The ’goto line (and column)’ menu.</p> <p style="margin-left:11%;"><b>writeout</b></p> -<p style="margin-left:15%;">The ’write file’ +<p style="margin-left:14%;">The ’write file’ menu.</p> <p style="margin-left:11%;"><b>insert</b></p> -<p style="margin-left:15%;">The ’insert file’ +<p style="margin-left:14%;">The ’insert file’ menu.</p> <p style="margin-left:11%;"><b>extcmd</b></p> -<p style="margin-left:15%;">The menu for inserting output -from an external comman, reached from the insert menu.</p> +<p style="margin-left:14%;">The menu for inserting output +from an external command, reached from the insert menu.</p> <p style="margin-left:11%;"><b>help</b></p> -<p style="margin-left:15%;">The help menu.</p> +<p style="margin-left:14%;">The help-viewer menu.</p> <p style="margin-left:11%;"><b>spell</b></p> -<p style="margin-left:15%;">The interactive spell checker +<p style="margin-left:14%;">The interactive spell checker Yes/no menu.</p> +<p style="margin-left:11%;"><b>linter</b></p> + +<p style="margin-left:14%;">The linter menu.</p> + <p style="margin-left:11%;"><b>browser</b></p> -<p style="margin-left:15%;">The file browser for inserting +<p style="margin-left:14%;">The file browser for inserting or writing a file.</p> <p style="margin-left:11%;"><b>whereisfile</b></p> -<p style="margin-left:15%;">The ’search for a +<p style="margin-left:14%;">The ’search for a file’ menu in the file browser.</p> <p style="margin-left:11%;"><b>gotodir</b></p> -<p style="margin-left:15%;">The ’go to -directory’ menu.</p> +<p style="margin-left:14%;">The ’go to +directory’ menu in the file browser.</p> <p style="margin-left:11%;"><b>all</b></p> -<p style="margin-left:15%;">A special name meaning: apply +<p style="margin-left:14%;">A special name meaning: apply to all menus where this function exists.</p> -<p style="margin-left:11%;"><b>unbind</b> <i>key -menu</i></p> - -<p style="margin-left:15%;">Unbind the key <i>key</i> from -the menu named <i>menu</i> or from all menus by using -<i>all</i>. Same key syntax as for binding. Rebinds the key -<i>key</i> to a new function named <i>function</i> in the -context of menu <i>menu</i>. The format of <i>key</i> should -be one of:</p> - <h2>FILES <a name="FILES"></a> </h2> -<p style="margin-left:11%; margin-top: 1em"><i>SYSCONFDIR/nanorc</i></p> +<p style="margin-left:11%; margin-top: 1em"><b>SYSCONFDIR/nanorc</b></p> <p style="margin-left:22%;">System-wide configuration file</p> -<p style="margin-left:11%;"><i>~/.nanorc</i></p> +<p style="margin-left:11%;"><b>~/.nanorc</b></p> <p style="margin-left:22%;">Per-user configuration file</p> @@ -960,21 +1083,24 @@ file</p> </h2> -<p style="margin-left:11%; margin-top: 1em"><b>nano</b>(1) -<i><br> -/usr/share/doc/nano/examples/nanorc.sample</i> (or -equivalent on your system)</p> + +<p style="margin-left:11%; margin-top: 1em"><b>nano</b>(1)</p> + + +<p style="margin-left:11%; margin-top: 1em"><i>/usr/share/doc/nano/examples/nanorc.sample</i> +(or equivalent on your system)</p> <h2>AUTHOR <a name="AUTHOR"></a> </h2> -<p style="margin-left:11%;">Chris Allegretta -<chrisa@asty.org>, et al (see <i>AUTHORS</i> and -<i>THANKS</i> for details). This manual page was originally -written by Jordi Mallach <jordi@gnu.org>, for the -Debian system (but may be used by others).</p> +<p style="margin-left:11%; margin-top: 1em">Chris +Allegretta <chrisa@asty.org>, et al (see +<i>AUTHORS</i> and <i>THANKS</i> for details). This manual +page was originally written by Jordi Mallach +<jordi@gnu.org>, for the Debian system (but may be +used by others).</p> <hr> </body> </html> diff --git a/doc/man/rnano.1 b/doc/man/rnano.1 index 6b8a9b8a..f4a3407f 100644 --- a/doc/man/rnano.1 +++ b/doc/man/rnano.1 @@ -19,8 +19,8 @@ .\" Documentation License along with this program. If not, see .\" <http://www.gnu.org/licenses/>. .\" -.\" $Id: rnano.1 4188 2007-12-08 04:27:44Z dolorous $ -.TH RNANO 1 "version 2.0.0" "August 23, 2007" +.\" $Id: rnano.1 4756 2014-04-08 20:01:17Z bens $ +.TH RNANO 1 "version 2.3.3" "April 2014" .\" Please adjust this date whenever revising the manpage. .\" .SH NAME @@ -29,18 +29,13 @@ Pico clone .SH SYNOPSIS .B rnano -.I [OPTIONS]\ [[\+LINE,COLUMN]\ FILE]... +.RI [ options "] [[\+" line , column "]\ " file "]..." .br .SH DESCRIPTION -This manual page briefly documents the \fBrnano\fP command. -.PP -.\" TeX users may be more comfortable with the \fB<whatever>\fP and -.\" \fI<whatever>\fP escape sequences to invoke bold face and italics, -.\" respectively. \fBnano\fP is a small, free and friendly editor which aims to replace -Pico, the default editor included in the non-free Pine package. Rather -than just copying Pico's look and feel, \fBnano\fP also implements some +Pico, the default editor included in the non-free Pine package. On +top of copying Pico's look and feel, \fBnano\fP also implements some missing (or disabled by default) features in Pico, such as "search and replace" and "go to line and column number". .PP @@ -63,14 +58,6 @@ use backup files or spell checking. .SH OPTIONS .TP -.B \+\fILINE\fP,\fICOLUMN\fP -Places cursor at line number \fILINE\fP and column number \fICOLUMN\fP -(at least one of which must be specified) on startup, instead of the -default of line 1, column 1. -.TP -.B \-? -Same as \fB-h (\-\-help)\fP. -.TP .B \-h (\-\-help) Show a summary of command line options and exit. .TP diff --git a/doc/man/rnano.1.html b/doc/man/rnano.1.html index b7bbc871..6b336020 100644 --- a/doc/man/rnano.1.html +++ b/doc/man/rnano.1.html @@ -1,5 +1,5 @@ -<!-- Creator : groff version 1.20.1 --> -<!-- CreationDate: Sat Jun 16 21:10:37 2012 --> +<!-- Creator : groff version 1.22.2 --> +<!-- CreationDate: Sat May 10 22:54:14 2014 --> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> @@ -46,22 +46,20 @@ free Pico clone</p> <p style="margin-left:11%; margin-top: 1em"><b>rnano</b> -<i>[OPTIONS] [[+LINE,COLUMN] FILE]...</i></p> +[<i>options</i>] +[[+<i>line</i>,<i>column</i>] <i>file</i>]...</p> <h2>DESCRIPTION <a name="DESCRIPTION"></a> </h2> -<p style="margin-left:11%; margin-top: 1em">This manual -page briefly documents the <b>rnano</b> command.</p> - <p style="margin-left:11%; margin-top: 1em"><b>nano</b> is a small, free and friendly editor which aims to replace Pico, the default editor included in the non-free Pine -package. Rather than just copying Pico’s look and -feel, <b>nano</b> also implements some missing (or disabled -by default) features in Pico, such as "search and +package. On top of copying Pico’s look and feel, +<b>nano</b> also implements some missing (or disabled by +default) features in Pico, such as "search and replace" and "go to line and column number".</p> @@ -139,32 +137,7 @@ under a different name;</p></td></tr> </h2> - -<p style="margin-left:11%; margin-top: 1em"><b>+</b><i>LINE</i><b>,</b><i>COLUMN</i></p> - -<p style="margin-left:22%;">Places cursor at line number -<i>LINE</i> and column number <i>COLUMN</i> (at least one of -which must be specified) on startup, instead of the default -of line 1, column 1.</p> - -<table width="100%" border="0" rules="none" frame="void" - cellspacing="0" cellpadding="0"> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="3%"> - - -<p><b>−?</b></p></td> -<td width="8%"></td> -<td width="30%"> - - -<p>Same as <b>-h (−−help)</b>.</p></td> -<td width="48%"> -</td></tr> -</table> - -<p style="margin-left:11%;"><b>−h +<p style="margin-left:11%; margin-top: 1em"><b>−h (−−help)</b></p> <p style="margin-left:22%;">Show a summary of command line diff --git a/doc/nanorc.sample.in b/doc/nanorc.sample.in index 192f9b44..d2dc9661 100644 --- a/doc/nanorc.sample.in +++ b/doc/nanorc.sample.in @@ -5,7 +5,7 @@ ## DOS or Mac format, and that characters specially interpreted by the ## shell should not be escaped here. ## -## To make sure a value is disabled, use "unset <option>". +## To make sure an option is disabled, use "unset <option>". ## ## For the options that take parameters, the default value is given. ## Other options are unset by default. @@ -15,10 +15,15 @@ ## its end. For example, for the "brackets" option, ""')>]}" will match ## ", ', ), >, ], and }. +## Silently ignore problems with unknown directives in the nanorc file. +## Useful when your nanorc file might be read on systems with multiple +## versions of nano installed (e.g. your home directory is on NFS). +# set quiet + ## Use auto-indentation. # set autoindent -## Backup files to filename~. +## Back up files to the current filename plus a tilde. # set backup ## The directory to put unique backup files in. @@ -34,23 +39,21 @@ ## paragraphs. They cannot contain blank characters. Only closing ## punctuation, optionally followed by closing brackets, can end ## sentences. -## # set brackets ""')>]}" -## Do case sensitive searches by default. +## Do case-sensitive searches by default. # set casesensitive ## Constantly display the cursor position in the statusbar. Note that ## this overrides "quickblank". # set const -## Use cut to end of line by default. +## Use cut-to-end-of-line by default. # set cut ## Set the line length for wrapping text and justifying paragraphs. -## If fill is 0 or less, the line length will be the screen width less -## this number. -## +## If the value is 0 or less, the wrapping point will be the screen +## width less this number. # set fill -8 ## Enable ~/.nano_history for saving and reading search/replace strings. @@ -64,7 +67,6 @@ ## The opening and closing brackets that can be found by bracket ## searches. They cannot contain blank characters. The former set must ## come before the latter set, and both must be in the same order. -## # set matchbrackets "(<[{)>]}" ## Use the blank line below the titlebar as extra editing space. @@ -74,13 +76,10 @@ ## mouse clicks can be used to place the cursor, set the mark (with a ## double click), and execute shortcuts. The mouse will work in the X ## Window System, and on the console when gpm is running. -## # set mouse -## Allow multiple file buffers (inserting a file will put it into a -## separate buffer). You must have configured with --enable-multibuffer -## for this to work. -## +## Switch on multiple file buffers (inserting a file will put it into +## a separate buffer). # set multibuffer ## Don't convert files from DOS/Mac format. @@ -101,10 +100,12 @@ ## Set operating directory. nano will not read or write files outside ## this directory and its subdirectories. Also, the current directory ## is changed to here, so any files are inserted from this dir. A blank -## string means the operating directory feature is turned off. -## +## string means the operating-directory feature is turned off. # set operatingdir "" +## Remember the cursor position in each file for the next editing session. +# set poslog + ## Preserve the XON and XOFF keys (^Q and ^S). # set preserve @@ -112,19 +113,18 @@ ## paragraphs. They cannot contain blank characters. Only closing ## punctuation, optionally followed by closing brackets, can end ## sentences. -## # set punct "!.?" ## Do quick statusbar blanking. Statusbar messages will disappear after ## 1 keystroke instead of 26. Note that "const" overrides this. -## # set quickblank ## The email-quote string, used to justify email-quoted paragraphs. ## This is an extended regular expression if your system supports them, -## otherwise a literal string. Default: +## otherwise a literal string. +## If you have extended regular expression support, the default is: # set quotestr "^([ ]*[#:>\|}])+" -## if you have extended regular expression support, otherwise: +## Otherwise: # set quotestr "> " ## Fix Backspace/Delete confusion problem. @@ -146,12 +146,11 @@ ## Use smooth scrolling as the default. # set smooth -## Enable soft line wrapping (AKA full line display). +## Enable soft line wrapping (AKA full-line display). # set softwrap ## Use this spelling checker instead of the internal one. This option ## does not properly have a default value. -## # set speller "aspell -x -c" ## Allow nano to be suspended. @@ -176,14 +175,25 @@ ## The two single-column characters used to display the first characters ## of tabs and spaces. 187 in ISO 8859-1 (0000BB in Unicode) and 183 in ## ISO-8859-1 (0000B7 in Unicode) seem to be good values for these. -# set whitespace " " +## The default when in a UTF-8 locale: +# set whitespace "»·" +## The default otherwise: +# set whitespace ">." ## Detect word boundaries more accurately by treating punctuation ## characters as parts of words. # set wordbounds -## Color setup +## Paint the interface elements of nano. +## This is an example, by default there are no colors. +# set titlecolor brightwhite,blue +# set statuscolor brightwhite,green +# set keycolor green +# set functioncolor yellow + + +## Setup of syntax coloring. ## ## Format: ## @@ -198,8 +208,8 @@ ## or ## icolor foreground,background "regex" ["regex"...] ## -## "color" will do case sensitive matches, while "icolor" will do case -## insensitive matches. +## "color" will do case-sensitive matches, while "icolor" will do +## case-insensitive matches. ## ## Valid colors: white, black, red, blue, green, yellow, magenta, cyan. ## For foreground colors, you may use the prefix "bright" to get a @@ -212,9 +222,10 @@ ## color will use a transparent color. If you don't want this, be sure ## to set the background color to black or white. ## -## If you wish, you may put your syntaxes in separate files. You can -## make use of such files (which can only include "syntax", "color", and -## "icolor" commands) as follows: +## All regexes should be extended regular expressions. +## +## If you wish, you may put your syntax definitions in separate files. +## You can make use of such files as follows: ## ## include "/path/to/syntax_file.nanorc" ## @@ -223,95 +234,18 @@ ## name inside that file. These names are kept fairly short to make ## them easier to remember and faster to type using nano's -Y option. ## -## All regexes should be extended regular expressions. +## To include all existing syntax definitions, you can do: +# include "@PKGDATADIR@/*.nanorc" + -## Key bindings -## Please see nanorc(5) for more details on this +## Key bindings. +## See nanorc(5) for more details on this. ## -## Here are some samples to get you going +## Here are a few samples to get you going. ## # bind M-W nowrap main # bind M-A casesens search # bind ^S research main -## Set this if your backspace key sends delete most of the time (2.1.3+) -# bind kdel backspace all - - -## Nanorc files -# include "@PKGDATADIR@/nanorc.nanorc" - -## C/C++ -# include "@PKGDATADIR@/c.nanorc" - -## Makefiles -# include "@PKGDATADIR@/makefile.nanorc" - -## Cascading Style Sheets -# include "@PKGDATADIR@/css.nanorc" - -## Debian files -# include "@PKGDATADIR@/debian.nanorc" - -## Gentoo files -# include "@PKGDATADIR@/gentoo.nanorc" - -## HTML -# include "@PKGDATADIR@/html.nanorc" - -## PHP -# include "@PKGDATADIR@/php.nanorc" - -## TCL -# include "@PKGDATADIR@/tcl.nanorc" - -## TeX -# include "@PKGDATADIR@/tex.nanorc" - -## Quoted emails (under e.g. mutt) -# include "@PKGDATADIR@/mutt.nanorc" - -## Patch files -# include "@PKGDATADIR@/patch.nanorc" - -## Manpages -# include "@PKGDATADIR@/man.nanorc" - -## Groff -# include "@PKGDATADIR@/groff.nanorc" - -## Perl -# include "@PKGDATADIR@/perl.nanorc" - -## Python -# include "@PKGDATADIR@/python.nanorc" - -## Ruby -# include "@PKGDATADIR@/ruby.nanorc" - -## Java -# include "@PKGDATADIR@/java.nanorc" - -## Fortran -# include "@PKGDATADIR@/fortran.nanorc" - -## Objective-C -# include "@PKGDATADIR@/objc.nanorc" - -## OCaml -# include "@PKGDATADIR@/ocaml.nanorc" - -## AWK -# include "@PKGDATADIR@/awk.nanorc" - -## Assembler -# include "@PKGDATADIR@/asm.nanorc" - -## Bourne shell scripts -# include "@PKGDATADIR@/sh.nanorc" - -## POV-Ray -# include "@PKGDATADIR@/pov.nanorc" - -## XML-type files -# include "@PKGDATADIR@/xml.nanorc" +## Set this if your backspace key sends Del most of the time. +# bind Del backspace all diff --git a/doc/syntax/Makefile.am b/doc/syntax/Makefile.am index 13bf6194..03bc8e3e 100644 --- a/doc/syntax/Makefile.am +++ b/doc/syntax/Makefile.am @@ -1,14 +1,19 @@ pkgdata_DATA = asm.nanorc \ awk.nanorc \ + changelog.nanorc \ cmake.nanorc \ c.nanorc \ css.nanorc \ debian.nanorc \ + default.nanorc \ fortran.nanorc \ gentoo.nanorc \ + go.nanorc \ groff.nanorc \ html.nanorc \ java.nanorc \ + javascript.nanorc \ + json.nanorc \ lua.nanorc \ makefile.nanorc \ man.nanorc \ @@ -20,6 +25,7 @@ pkgdata_DATA = asm.nanorc \ patch.nanorc \ perl.nanorc \ php.nanorc \ + po.nanorc \ pov.nanorc \ python.nanorc \ ruby.nanorc \ @@ -27,6 +33,7 @@ pkgdata_DATA = asm.nanorc \ spec.nanorc \ tcl.nanorc \ tex.nanorc \ + texinfo.nanorc \ xml.nanorc EXTRA_DIST = $(pkgdata_DATA) diff --git a/doc/syntax/Makefile.in b/doc/syntax/Makefile.in index 2f3dd6e7..c61d0134 100644 --- a/doc/syntax/Makefile.in +++ b/doc/syntax/Makefile.in @@ -1,9 +1,8 @@ -# Makefile.in generated by automake 1.11.6 from Makefile.am. +# Makefile.in generated by automake 1.13.3 from Makefile.am. # @configure_input@ -# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, -# 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software -# Foundation, Inc. +# Copyright (C) 1994-2013 Free Software Foundation, Inc. + # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, # with or without modifications, as long as this notice is preserved. @@ -16,23 +15,51 @@ @SET_MAKE@ VPATH = @srcdir@ -am__make_dryrun = \ - { \ - am__dry=no; \ +am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__make_running_with_option = \ + case $${target_option-} in \ + ?) ;; \ + *) echo "am__make_running_with_option: internal error: invalid" \ + "target option '$${target_option-}' specified" >&2; \ + exit 1;; \ + esac; \ + has_opt=no; \ + sane_makeflags=$$MAKEFLAGS; \ + if $(am__is_gnu_make); then \ + sane_makeflags=$$MFLAGS; \ + else \ case $$MAKEFLAGS in \ *\\[\ \ ]*) \ - echo 'am--echo: ; @echo "AM" OK' | $(MAKE) -f - 2>/dev/null \ - | grep '^AM OK$$' >/dev/null || am__dry=yes;; \ - *) \ - for am__flg in $$MAKEFLAGS; do \ - case $$am__flg in \ - *=*|--*) ;; \ - *n*) am__dry=yes; break;; \ - esac; \ - done;; \ + bs=\\; \ + sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \ + | sed "s/$$bs$$bs[$$bs $$bs ]*//g"`;; \ esac; \ - test $$am__dry = yes; \ - } + fi; \ + skip_next=no; \ + strip_trailopt () \ + { \ + flg=`printf '%s\n' "$$flg" | sed "s/$$1.*$$//"`; \ + }; \ + for flg in $$sane_makeflags; do \ + test $$skip_next = yes && { skip_next=no; continue; }; \ + case $$flg in \ + *=*|--*) continue;; \ + -*I) strip_trailopt 'I'; skip_next=yes;; \ + -*I?*) strip_trailopt 'I';; \ + -*O) strip_trailopt 'O'; skip_next=yes;; \ + -*O?*) strip_trailopt 'O';; \ + -*l) strip_trailopt 'l'; skip_next=yes;; \ + -*l?*) strip_trailopt 'l';; \ + -[dEDm]) skip_next=yes;; \ + -[JT]) skip_next=yes;; \ + esac; \ + case $$flg in \ + *$$target_option*) has_opt=yes; break;; \ + esac; \ + done; \ + test $$has_opt = yes +am__make_dryrun = (target_option=n; $(am__make_running_with_option)) +am__make_keepgoing = (target_option=k; $(am__make_running_with_option)) pkgdatadir = $(datadir)/@PACKAGE@ pkgincludedir = $(includedir)/@PACKAGE@ pkglibdir = $(libdir)/@PACKAGE@ @@ -52,9 +79,11 @@ POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ subdir = doc/syntax -DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in +DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ + $(top_srcdir)/mkinstalldirs ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ac_define_dir.m4 \ + $(top_srcdir)/m4/ax_check_compile_flag.m4 \ $(top_srcdir)/m4/gettext.m4 $(top_srcdir)/m4/glib-2.0.m4 \ $(top_srcdir)/m4/iconv.m4 $(top_srcdir)/m4/isc-posix.m4 \ $(top_srcdir)/m4/lib-ld.m4 $(top_srcdir)/m4/lib-link.m4 \ @@ -66,6 +95,18 @@ mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = CONFIG_CLEAN_VPATH_FILES = +AM_V_P = $(am__v_P_@AM_V@) +am__v_P_ = $(am__v_P_@AM_DEFAULT_V@) +am__v_P_0 = false +am__v_P_1 = : +AM_V_GEN = $(am__v_GEN_@AM_V@) +am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@) +am__v_GEN_0 = @echo " GEN " $@; +am__v_GEN_1 = +AM_V_at = $(am__v_at_@AM_V@) +am__v_at_ = $(am__v_at_@AM_DEFAULT_V@) +am__v_at_0 = @ +am__v_at_1 = SOURCES = DIST_SOURCES = am__can_run_installinfo = \ @@ -102,9 +143,11 @@ am__uninstall_files_from_dir = { \ } am__installdirs = "$(DESTDIR)$(pkgdatadir)" DATA = $(pkgdata_DATA) +am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ AMTAR = @AMTAR@ +AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ @@ -150,7 +193,11 @@ MKDIR_P = @MKDIR_P@ MKINSTALLDIRS = @MKINSTALLDIRS@ MSGFMT = @MSGFMT@ MSGMERGE = @MSGMERGE@ +NCURSESW_CFLAGS = @NCURSESW_CFLAGS@ NCURSESW_CONFIG = @NCURSESW_CONFIG@ +NCURSESW_LIBS = @NCURSESW_LIBS@ +NCURSES_CFLAGS = @NCURSES_CFLAGS@ +NCURSES_LIBS = @NCURSES_LIBS@ OBJEXT = @OBJEXT@ PACKAGE = @PACKAGE@ PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ @@ -162,6 +209,8 @@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ PKGDATADIR = @PKGDATADIR@ PKG_CONFIG = @PKG_CONFIG@ +PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@ +PKG_CONFIG_PATH = @PKG_CONFIG_PATH@ POSUB = @POSUB@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ @@ -191,6 +240,7 @@ datarootdir = @datarootdir@ docdir = @docdir@ dvidir = @dvidir@ exec_prefix = @exec_prefix@ +haveit = @haveit@ host = @host@ host_alias = @host_alias@ host_cpu = @host_cpu@ @@ -221,15 +271,20 @@ top_builddir = @top_builddir@ top_srcdir = @top_srcdir@ pkgdata_DATA = asm.nanorc \ awk.nanorc \ + changelog.nanorc \ cmake.nanorc \ c.nanorc \ css.nanorc \ debian.nanorc \ + default.nanorc \ fortran.nanorc \ gentoo.nanorc \ + go.nanorc \ groff.nanorc \ html.nanorc \ java.nanorc \ + javascript.nanorc \ + json.nanorc \ lua.nanorc \ makefile.nanorc \ man.nanorc \ @@ -241,6 +296,7 @@ pkgdata_DATA = asm.nanorc \ patch.nanorc \ perl.nanorc \ php.nanorc \ + po.nanorc \ pov.nanorc \ python.nanorc \ ruby.nanorc \ @@ -248,6 +304,7 @@ pkgdata_DATA = asm.nanorc \ spec.nanorc \ tcl.nanorc \ tex.nanorc \ + texinfo.nanorc \ xml.nanorc EXTRA_DIST = $(pkgdata_DATA) @@ -305,11 +362,11 @@ uninstall-pkgdataDATA: @list='$(pkgdata_DATA)'; test -n "$(pkgdatadir)" || list=; \ files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \ dir='$(DESTDIR)$(pkgdatadir)'; $(am__uninstall_files_from_dir) -tags: TAGS -TAGS: +tags TAGS: + +ctags CTAGS: -ctags: CTAGS -CTAGS: +cscope cscopelist: distdir: $(DISTFILES) @@ -447,16 +504,17 @@ uninstall-am: uninstall-pkgdataDATA .MAKE: install-am install-strip -.PHONY: all all-am check check-am clean clean-generic distclean \ - distclean-generic distdir dvi dvi-am html html-am info info-am \ - install install-am install-data install-data-am install-dvi \ - install-dvi-am install-exec install-exec-am install-html \ - install-html-am install-info install-info-am install-man \ - install-pdf install-pdf-am install-pkgdataDATA install-ps \ - install-ps-am install-strip installcheck installcheck-am \ - installdirs maintainer-clean maintainer-clean-generic \ - mostlyclean mostlyclean-generic pdf pdf-am ps ps-am uninstall \ - uninstall-am uninstall-pkgdataDATA +.PHONY: all all-am check check-am clean clean-generic cscopelist-am \ + ctags-am distclean distclean-generic distdir dvi dvi-am html \ + html-am info info-am install install-am install-data \ + install-data-am install-dvi install-dvi-am install-exec \ + install-exec-am install-html install-html-am install-info \ + install-info-am install-man install-pdf install-pdf-am \ + install-pkgdataDATA install-ps install-ps-am install-strip \ + installcheck installcheck-am installdirs maintainer-clean \ + maintainer-clean-generic mostlyclean mostlyclean-generic pdf \ + pdf-am ps ps-am tags-am uninstall uninstall-am \ + uninstall-pkgdataDATA # Tell versions [3.59,3.63) of GNU make to not export all variables. diff --git a/doc/syntax/asm.nanorc b/doc/syntax/asm.nanorc index 9d927604..4e215915 100644 --- a/doc/syntax/asm.nanorc +++ b/doc/syntax/asm.nanorc @@ -1,18 +1,23 @@ ## Here is an example for assembler. -## + syntax "asm" "\.(S|s|asm)$" magic "[Aa]ssembl(y|er)" + color red "\<[A-Z_]{2,}\>" color brightgreen "\.(data|subsection|text)" color green "\.(align|file|globl|global|hidden|section|size|type|weak)" color brightyellow "\.(ascii|asciz|byte|double|float|hword|int|long|short|single|struct|word)" icolor brightred "^[[:space:]]*[.0-9A-Z_]*:" color brightcyan "^[[:space:]]*#[[:space:]]*(define|undef|include|ifn?def|endif|elif|else|if|warning|error)" -## Highlight strings (note: VERY resource intensive) + +# Strings. color brightyellow "<[^= ]*>" ""(\\.|[^"])*"" +# Multiline strings (note: VERY resource intensive). color brightyellow start=""(\\.|[^"])*\\[[:space:]]*$" end="^(\\.|[^"])*"" -## Highlight comments + +# Comments. color brightblue "//.*" color brightblue start="/\*" end="\*/" -## Highlight trailing whitespace + +# Trailing whitespace. color ,green "[[:space:]]+$" diff --git a/doc/syntax/awk.nanorc b/doc/syntax/awk.nanorc index b84d2fdc..bfc6387c 100644 --- a/doc/syntax/awk.nanorc +++ b/doc/syntax/awk.nanorc @@ -1,24 +1,25 @@ ## Here is an example for awk. -## + syntax "awk" "\.awk$" magic "awk.*script text" -## records + +# Records. icolor brightred "\$[0-9A-Z_!@#$*?-]+" -## awk-set variables +# Awk-set variables. color red "\<(ARGC|ARGIND|ARGV|BINMODE|CONVFMT|ENVIRON|ERRNO|FIELDWIDTHS)\>" color red "\<(FILENAME|FNR|FS|IGNORECASE|LINT|NF|NR|OFMT|OFS|ORS)\>" color red "\<(PROCINFO|RS|RT|RSTART|RLENGTH|SUBSEP|TEXTDOMAIN)\>" -## function declarations and special patterns +# Function declarations and special patterns. color brightgreen "\<(function|extension|BEGIN|END)\>" -## operators +# Operators. color green "(\{|\}|\(|\)|\;|\]|\[|\\|<|>|!|=|&|\+|-|\*|%|/|\?:|\^|\|)" -## flow control +# Flow control. color brightyellow "\<(for|if|while|do|else|in|delete|exit)\>" color brightyellow "\<(break|continue|return)\>" -## I/O statements +# I/O statements. color brightgreen "\<(close|getline|next|nextfile|print|printf)\>" color brightgreen "\<(system|fflush)\>" -## standard functions +# Standard functions. color magenta "\<(atan2|cos|exp|int|log|rand|sin|sqrt|srand)\>" color magenta "\<(asort|asorti|gensub|gsub|index|length|match)\>" color magenta "\<(split|sprintf|strtonum|sub|substr|tolower|toupper)\>" @@ -26,14 +27,10 @@ color magenta "\<(mktime|strftime|systime)\>" color magenta "\<(and|compl|lshift|or|rshift|xor)\>" color magenta "\<(bindtextdomain|dcgettext|dcngettext)\>" -## -## String highlighting. You will in general want your comments and -## strings to come last, because syntax highlighting rules will be -## applied in the order they are read in. +# Strings. color brightyellow "<[^= ]*>" ""(\\.|[^"])*"" - -## Comment highlighting +# Comments. color brightblue "(^|[[:space:]])#.*$" -## Trailing whitespace +# Trailing whitespace. color ,green "[[:space:]]+$" diff --git a/doc/syntax/c.nanorc b/doc/syntax/c.nanorc index 59f0f3b6..8fe7088d 100644 --- a/doc/syntax/c.nanorc +++ b/doc/syntax/c.nanorc @@ -1,9 +1,10 @@ ## Here is an example for C/C++. -## -syntax "c" "\.(c(c|pp|xx)?|C)$" "\.(h(h|pp|xx)?|H)$" "\.ii?$" -magic "ASCII C(\+\+)? program text" -color brightred "\<[A-Z_][0-9A-Z_]+\>" -color green "\<(float|double|bool|char|int|short|long|sizeof|enum|void|static|const|struct|union|typedef|extern|(un)?signed|inline)\>" + +syntax "c" "\.(c(c|pp|xx|\+\+)?|C)$" "\.(h(h|pp|xx)?|H)$" "\.ii?$" +magic "(ASCII|UTF-8 Unicode) C(\+\+)? program text" + +color brightred "\<[A-Z_][0-9A-Z_]+\>" +color green "\<(float|double|bool|char|int|short|long|sizeof|enum|void|auto|static|const|struct|union|typedef|extern|(un)?signed|inline)\>" color green "\<((s?size)|((u_?)?int(8|16|32|64|ptr)))_t\>" color green "\<(class|namespace|template|public|protected|private|typename|this|friend|virtual|using|mutable|volatile|register|explicit)\>" color brightyellow "\<(for|if|while|do|else|case|default|switch)\>" @@ -11,21 +12,22 @@ color brightyellow "\<(try|throw|catch|operator|new|delete)\>" color magenta "\<(goto|continue|break|return)\>" color brightcyan "^[[:space:]]*#[[:space:]]*(define|include(_next)?|(un|ifn?)def|endif|el(if|se)|if|warning|error|pragma)" color brightmagenta "'([^'\]|(\\["'abfnrtv\\]))'" "'\\(([0-3]?[0-7]{1,2}))'" "'\\x[0-9A-Fa-f]{1,2}'" -## -## GCC builtins + +# GCC builtins. color cyan "__attribute__[[:space:]]*\(\([^)]*\)\)" "__(aligned|asm|builtin|hidden|inline|packed|restrict|section|typeof|weak)__" -## -## String highlighting. You will in general want your comments and -## strings to come last, because syntax highlighting rules will be -## applied in the order they are read in. + +# Strings. In general you will want your strings and comments to come last, +# because highlighting rules are applied in the order they are read in. color brightyellow "<[^= ]*>" ""(\\.|[^"])*"" -## -## This string is VERY resource intensive! +# Multiline strings. This regex is VERY resource intensive! color brightyellow start=""(\\.|[^"])*\\[[:space:]]*$" end="^(\\.|[^"])*"" -## Comment highlighting +# Comments. color brightblue "//.*" color brightblue start="/\*" end="\*/" -## Trailing whitespace +# Reminders. +color ,yellow "(FIXME|TODO|XXX)" + +# Trailing whitespace. color ,green "[[:space:]]+$" diff --git a/doc/syntax/changelog.nanorc b/doc/syntax/changelog.nanorc new file mode 100644 index 00000000..60666bd5 --- /dev/null +++ b/doc/syntax/changelog.nanorc @@ -0,0 +1,25 @@ +## Colouring for Changelogs. + +syntax "changelog" "Change[Ll]og.*" + +# Author lines. +color green "^(19|20).*$" +# Dates. +color red "^(19|20)[0-9-]{8}" +# Email addresses. +color yellow "<[^>]*@[^>]*>" + +# Changed files. +color magenta "[[:space:]]\*[[:space:]].*:" + +# Command-line options. +color cyan "[[:space:]]-[a-zA-Z\$]" "--[8a-z-]+" +# Bug numbers. +color cyan "bug #[0-9]{5}" +# Probable variables, for variety. +color brightred "\<[A-Z_][0-9A-Z_]+\>" +# Key sequences. +color brightblue "\^[A-Z]" "\<M-." "\<F1?[0-9]" "(\^|M-)Space" + +# Trailing whitespace. +color ,green "[[:space:]]+$" diff --git a/doc/syntax/cmake.nanorc b/doc/syntax/cmake.nanorc index 3c52f7de..dc437024 100644 --- a/doc/syntax/cmake.nanorc +++ b/doc/syntax/cmake.nanorc @@ -1,5 +1,5 @@ -## CMake syntax highlighter for GNU Nano -## +## Syntax highlighting for CMake files. + syntax "cmake" "(CMakeLists\.txt|\.cmake)$" icolor green "^[[:space:]]*[A-Z0-9_]+" diff --git a/doc/syntax/css.nanorc b/doc/syntax/css.nanorc index 98eea180..a806d7c5 100644 --- a/doc/syntax/css.nanorc +++ b/doc/syntax/css.nanorc @@ -1,6 +1,7 @@ -## Here is an example for css files. -## +## Here is an example for CSS files. + syntax "css" "\.css$" + color brightred "." color brightyellow start="\{" end="\}" color brightwhite start=":" end="([;^\{]|$)" diff --git a/doc/syntax/debian.nanorc b/doc/syntax/debian.nanorc index a945deea..1083abe7 100644 --- a/doc/syntax/debian.nanorc +++ b/doc/syntax/debian.nanorc @@ -1,20 +1,19 @@ -## Here is an exmaple for apt's sources.list -## Adapted from http://milianw.de/blog/Syntax-Highlighting-in-Nano -## (mail@milianw.de). -## +## Here is an example for apt's sources.list. + syntax "apt/sources.list" "sources\.list(\.old|~)?$" -# component -color brightmagenta "^deb(-src)? ((http|file|ftp):/[^ ]+|cdrom:\[[^\]]+\]/|cdrom:\[[-a-zA-Z0-9\._\(\) ]+\]/) [^ ]+ .+$" -# distribution -color brightred "^deb(-src)? ((http|file|ftp):/[^ ]+|cdrom:\[[^\]]+\]/|cdrom:\[[-a-zA-Z0-9\._\(\) ]+\]/) [^ ]+" -# URI -color brightgreen "(http|file|ftp):/[^ ]+" -# cdroms -# [^\]] does not work... + +# Coloring the deb lines, working from tail to head. First the +# components -- well, everything, and thus also the components. +color brightmagenta "^deb.*" +# Distribution -- well, everything, except the components. +color brightred "^deb(-src)? ((http|ftp|rsh|ssh|file|copy):/[^ ]+|cdrom:\[[-a-zA-Z0-9\._\(\) ]+\]/) [^ ]+" +# URIs. +color brightgreen "(http|ftp|rsh|ssh|file|copy):/[^ ]+" +# CDroms. color brightgreen "cdrom:\[[-a-zA-Z0-9\._\(\) ]+\]/" -# deb / deb-src -color yellow "^deb" -color yellow "^deb-src" -# comments +# And finally the initial deb tag. +color yellow "^deb(-src)?" + +# Comments. color brightblue "#.*" diff --git a/doc/syntax/default.nanorc b/doc/syntax/default.nanorc new file mode 100644 index 00000000..8d8e0397 --- /dev/null +++ b/doc/syntax/default.nanorc @@ -0,0 +1,13 @@ +## A default syntax, which is used +## for files that do not match any other syntax. + +syntax "default" + +# Spaces in front of tabs. +color ,red " + +" + +# Trailing blanks. +color ,red "[[:blank:]]+$" + +# Nano's name, including version. +color brightred "(GNU )?nano [1-9]\.[0-9]\.[^[:space:][:punct:]]+" diff --git a/doc/syntax/fortran.nanorc b/doc/syntax/fortran.nanorc index cc0c726a..45873ac7 100644 --- a/doc/syntax/fortran.nanorc +++ b/doc/syntax/fortran.nanorc @@ -1,9 +1,8 @@ -## Here is an example for Fortran 90/95 +## Here is an example for Fortran 90/95. -syntax "fortran" "\.(f|f90|f95)$" +syntax "fortran" "\.(f|f90|f95)$" -#color red "\<[A-Z_]a[0-9A-Z_]+\>" -color red "\<[0-9]+\>" +color red "\<[0-9]+\>" icolor green "\<(action|advance|all|allocatable|allocated|any|apostrophe)\>" icolor green "\<(append|asis|assign|assignment|associated|character|common)\>" @@ -15,16 +14,16 @@ icolor green "\<(operator|optional|pack|parameter|pointer|position|private)\>" icolor green "\<(program|public|real|recl|recursive|selected_int_kind)\>" icolor green "\<(selected_real_kind|subroutine|status)\>" -icolor cyan "\<(abs|achar|adjustl|adjustr|allocate|bit_size|call|char)\>" -icolor cyan "\<(close|contains|count|cpu_time|cshift|date_and_time)\>" -icolor cyan "\<(deallocate|digits|dot_product|eor|eoshift|function|iachar)\>" -icolor cyan "\<(iand|ibclr|ibits|ibset|ichar|ieor|iolength|ior|ishft|ishftc)\>" -icolor cyan "\<(lbound|len|len_trim|matmul|maxexponent|maxloc|maxval|merge)\>" -icolor cyan "\<(minexponent|minloc|minval|mvbits|namelist|nearest|nullify)\>" -icolor cyan "\<(open|pad|present|print|product|pure|quote|radix)\>" -icolor cyan "\<(random_number|random_seed|range|read|readwrite|replace)\>" -icolor cyan "\<(reshape|rewind|save|scan|sequence|shape|sign|size|spacing)\>" -icolor cyan "\<(spread|sum|system_clock|target|transfer|transpose|trim)\>" +icolor cyan "\<(abs|achar|adjustl|adjustr|allocate|bit_size|call|char)\>" +icolor cyan "\<(close|contains|count|cpu_time|cshift|date_and_time)\>" +icolor cyan "\<(deallocate|digits|dot_product|eor|eoshift|function|iachar)\>" +icolor cyan "\<(iand|ibclr|ibits|ibset|ichar|ieor|iolength|ior|ishft|ishftc)\>" +icolor cyan "\<(lbound|len|len_trim|matmul|maxexponent|maxloc|maxval|merge)\>" +icolor cyan "\<(minexponent|minloc|minval|mvbits|namelist|nearest|nullify)\>" +icolor cyan "\<(open|pad|present|print|product|pure|quote|radix)\>" +icolor cyan "\<(random_number|random_seed|range|read|readwrite|replace)\>" +icolor cyan "\<(reshape|rewind|save|scan|sequence|shape|sign|size|spacing)\>" +icolor cyan "\<(spread|sum|system_clock|target|transfer|transpose|trim)\>" icolor cyan "\<(ubound|unpack|verify|write|tiny|type|use|yes)\>" icolor yellow "\<(.and.|case|do|else|else?if|else?where|end|end?do|end?if)\>" @@ -33,9 +32,8 @@ icolor yellow "\<(.or.|repeat|select case|then|where|while)\>" icolor magenta "\<(continue|cycle|exit|go?to|result|return)\>" -## String highlighting. +# Strings. icolor yellow "<[^= ]*>" ""(\\.|[^"])*"" -## Comment highlighting +# Comments. icolor blue "!.*" - diff --git a/doc/syntax/gentoo.nanorc b/doc/syntax/gentoo.nanorc index 2ad15971..249e224d 100644 --- a/doc/syntax/gentoo.nanorc +++ b/doc/syntax/gentoo.nanorc @@ -1,31 +1,41 @@ -## Here is an example for Gentoo ebuilds/eclasses -## +## Here is an example for Gentoo ebuilds/eclasses. + syntax "ebuild" "\.e(build|class)$" + ## All the standard portage functions -color brightgreen "^src_(unpack|prepare|configure|compile|install|test)" "^pkg_(config|nofetch|setup|(pre|post)(inst|rm))" +color brightgreen "(^|\<default_)src_(unpack|prepare|configure|compile|install|test)\>" +color brightgreen "^pkg_(config|nofetch|info|pretend|setup|(pre|post)(inst|rm))\>" +color brightgreen "\<default(_pkg_nofetch|_src_(unpack|prepare|configure|compile|test))?\>" ## Highlight bash related syntax -color green "\<(case|do|done|elif|else|esac|exit|fi|for|function|if|in|local|read|return|select|shift|then|time|until|while|continue|break)\>" -color green "\<(declare|eval|exec|let)\>" -color green "(\{|\}|\(|\)|\;|\]|\[|`|\\|\$|<|>|!|=|&|\|)" -color green "-[edfgruwxL]\>" -color green "-(eq|ne|gt|lt|ge|le|s|n|z)\>" +color green "\<(break|case|continue|do|done|elif|else|esac|exit|fi|for|function|if|in|read|return|select|shift|then|time|until|while)\>" +color green "\<(declare|eval|exec|export|let|local)\>" +color green "[{}():;|`$<>!=&\\]" "(\]|\[)" +color green "-[defhnrsuwxzL]\>" +color green "-(eq|ne|gt|lt|ge|le)\>" ## Highlight variables ... official portage ones in red, all others in bright red -color brightred "\$\{?[a-zA-Z_0-9]+\}?" -color red "\<(EAPI|ARCH|HOMEPAGE|DESCRIPTION|IUSE|SRC_URI|LICENSE|SLOT|KEYWORDS|(P|R)?DEPEND|PROVIDE|PROPERTIES|RESTRICT|USERLAND)\>" -color red "\<(S|D|T|PV|PF|P|PN|PR|PVR|A|CATEGORY|DISTDIR|FILESDIR|ROOT|WORKDIR)\>" "\<(AS|C(PP|XX)?|LD)FLAGS\>" "\<C(HOST|TARGET|BUILD)\>" -color red "\<QA_((TEXTRELS|EXECSTACK|WX_LOAD)(_[a-zA-Z_0-9]+)?|DT_HASH|PRESTRIPPED)\>" "\<WANT_AUTO(CONF|MAKE)\>" "\<AT_M4DIR\>" +color brightred "\$[-0-9@*#?$!]" "\$[[:alpha:]_][[:alnum:]_]*" +color brightred "\$\{[#!]?([-@*#?$!]|[0-9]+|[[:alpha:]_][[:alnum:]_]*)(\[([[:digit:]]|@)+\])?(([#%/]|:?[-=?+])[^}]*\}|\[|\})" +color red "\<(EAPI|ARCH|HOMEPAGE|DESCRIPTION|IUSE|SRC_URI|LICENSE|SLOT|KEYWORDS|[HPR]?DEPEND|PROVIDE|PROPERTIES|REQUIRED_USE|RESTRICT|USERLAND)\>" +color red "\<(S|E?D|T|PV|PF|P|PN|PR|PVR|A|CATEGORY|DISTDIR|FILESDIR|EPREFIX|E?ROOT|WORKDIR)\>" +color red "\<(AS|C(PP|XX)?|LD)FLAGS\>" "\<C(HOST|TARGET|BUILD)\>" "\<(MERGE_TYPE|REPLACING_VERSIONS|REPLACED_BY_VERSION)\>" +color red "\<EBUILD_PHASE(_FUNC)?\>" +color red "\<QA_((TEXTRELS|EXECSTACK|WX_LOAD)(_[a-zA-Z_0-9]+)?|DT_HASH|PRESTRIPPED)\>" +color red "\<(PATCHES|(HTML_)?DOCS)\>" "\<WANT_(AUTO(CONF|MAKE)|LIBTOOL)\>" "\<AT_M4DIR\>" ## Highlight portage commands -color magenta "\<use(_(with|enable))?\> [!a-zA-Z0-9_+ -]*" "inherit.*" -color brightblue "\<e(begin|end|conf|install|make|qmake[34]|ant|(qa)?warn|infon?|error|log|patch|new(group|user))\>" -color brightblue "\<e(pause|beep|mktemp|(cvs|svn)_clean|punt_cxx)\>" "\<e(aclocal|auto(reconf|header|conf|make))\>" -color brightblue "\<built_with_use\>" "\<make_desktop_entry\>" "\<unpack(_(makeself|pdv))?\>" -color brightblue "\<die\>" "\<use(_(with|enable))?\>" "\<inherit\>" "\<has\>" "\<(has|best)_version\>" +color magenta "\<(use(_(with|enable|if_iuse)|x)?|in_iuse)\> [!a-zA-Z0-9_+ -]*" "inherit.*" +color brightblue "\<e(begin|end|conf|install|make|qmake4|ant|(qa)?warn|infon?|error|log|patch(_user)?|new(group|user))\>" +color brightblue "\<e(pause|beep|mktemp|(cvs|svn)_clean|punt_cxx)\>" "\<e(aclocal|auto(reconf|header|conf|make)|libtoolize)\>" +color brightblue "\<e(stack|shopts|umask)_(push|pop)\>" "\<version_is_at_least\>" +color brightblue "\<make_desktop_entry\>" "\<unpack(_(makeself|pdv))?\>" +color brightblue "\<(die|hasv?|inherit|nonfatal)\>" "\<(use(_(with|enable|if_iuse)|x)?|in_iuse)\>" "\<(has|best)_version\>" color brightblue "\<(do|new)(ins|(games)?s?bin|doc|lib(\.so|\.a)?|man|info|exe|initd|confd|envd|pam|menu|icon)\>" -color brightblue "\<do(python|sed|dir|hard|sym|html|jar|mo)\>" "\<keepdir\>" -color brightblue "prepall(docs|info|man|strip)?" "prep(info|lib|lib\.(so|a)|man|strip|gamesdirs)" +color brightblue "\<do(compress|header|python|sed|dir|hard|sym|html|jar|mo)\>" "\<keepdir\>" +color brightblue "\<prepall(docs|info|man|strip)?\>" "\<prep(info|lib|lib\.(so|a)|man|strip|gamesdirs)\>" color brightblue "\<(doc|ins|exe)?into\>" "\<(f|games)(owners|perms)\>" "\<(exe|ins|dir)opts\>" +color brightblue "\<tc-get(BUILD_)?(AR|AS|CC|CPP|CXX|LD|NM|OBJCOPY|PKG_CONFIG|RANLIB)\>" +color brightblue "\<tc-(arch(-kernel)?|export|has-(tls|openmp))\>" ## Highlight common commands used in ebuilds -color blue "\<make\>" "\<(awk|cat|cd|chmod|chown|cp|echo|env|export|find|e?grep|ln|mkdir|mv|rm|sed|set|tar|touch|unset|xargs)\>" +color blue "\<(awk|cat|cd|chmod|chown|cp|echo|env|find|e?grep|ln|make|mkdir|mv|popd|printf|pushd|rm|rmdir|sed|set|tar|touch|unset|xargs)\>" ## Highlight comments (doesnt work that well) color yellow "(^|[[:space:]])#.*$" ## Highlight strings (doesnt work that well) @@ -33,9 +43,9 @@ color brightyellow ""(\\.|[^\"])*"" "'(\\.|[^'])*'" ## Trailing space is bad! color ,green "[[:space:]]+$" -## Here is an example for Portage control files +## Here is an example for Portage control files. ## -syntax "/etc/portage" "\.(keywords|mask|unmask|use)(/.+)?$" +syntax "/etc/portage" "\.(accept_keywords|env|keywords|mask|unmask|use)(/.+)?$" ## Base text: color green "^.+$" ## Use flags: @@ -53,3 +63,5 @@ color cyan "^[[:space:]]*.*/" color brightmagenta "^[[:space:]]*(=|~|<|<=|=<|>|>=|=>)" ## Comments: color yellow "#.*$" +## Trailing space is bad! +color ,green "[[:space:]]+$" diff --git a/doc/syntax/go.nanorc b/doc/syntax/go.nanorc new file mode 100644 index 00000000..58ef1812 --- /dev/null +++ b/doc/syntax/go.nanorc @@ -0,0 +1,42 @@ +## Here is an example for Go. + +syntax "go" "\.go$" + +# Types. +color green "\<(bool|u?int(8|16|32|64)?|float(32|64)|complex(64|128)|byte|rune|uintptr|string|error)\>" +color green "\<((<-[[:space:]]*)chan|chan[[:space:]]*<-|const|func|interface|map|struct|type|var)\>" + +# Predefined functions. +color blue "\<(append|cap|close|complex|copy|delete|imag|len|make|new|panic|print|println|real|recover)\>" + +# Control structures. +color brightyellow "\<(case|default|defer|else|for|go|if|range|select|switch)\>" + +# Control flow. +color magenta "\<(break|continue|fallthrough|goto|return)\>" + +# Declarations. +color brightcyan "\<(package|import)\>" +color brightcyan "//[[:space:]]*\+build[[:space:]]+(([a-zA-Z_0-9]+[[:space:]]*)+,[[:space:]]*)*[a-zA-Z_0-9]+" + +# Literals. +color red "\<[0-9]+\.[0-9]*([Ee][+-][0-9]+)?i?\>" +color red "\<[0-9]+[Ee][+-][0-9]+i?\>" +color red "\<\.[0-9]+([Ee][+-][0-9]+)?i?\>" +color red "\<[0-9]+i\>" +color red "\<[1-9][0-9]*\>" +color red "\<0[0-7]*\>" +icolor red "\<0x[0-9a-f]+\>" + +# Strings and characters; slightly fuzzy. +color red "\<(true|false|nil|iota|_)\>" +color red "'(\\.|[^'])+'" +color red ""(\\.|[^"])*"" +color red start=""(\\.|[^"])*\\[[:space:]]*$" end="^(\\.|[^"])*"" + +# Comments. +color brightblue "//.*" +color brightblue start="/\*" end="\*/" + +# Trailing whitespace. +color ,green "[[:space:]]+$" diff --git a/doc/syntax/groff.nanorc b/doc/syntax/groff.nanorc index 02b82b8e..70f641d3 100644 --- a/doc/syntax/groff.nanorc +++ b/doc/syntax/groff.nanorc @@ -1,24 +1,25 @@ ## Here is an example for groff. -## + syntax "groff" "\.m[ems]$" "\.rof" "\.tmac$" "^tmac." -## The argument of .ds or .nr + +# The argument of .ds or .nr color cyan "^\.(ds|nr) [^[[:space:]]]*" -## Single character escapes +# Single-character escapes color brightmagenta "\\." -## Highlight the argument of \f or \s in the same color +# The argument of \f or \s in the same color color brightmagenta "\\f." "\\f\(.." "\\s(\+|\-)?[0-9]" -## Newlines +# Newlines color cyan "(\\|\\\\)n(.|\(..)" color cyan start="(\\|\\\\)n\[" end="]" -## Requests +# Requests color brightgreen "^\.[[:space:]]*[^[[:space:]]]*" -## Comments +# Comments color yellow "^\.\\".*$" -## Strings +# Strings color green "(\\|\\\\)\*(.|\(..)" color green start="(\\|\\\\)\*\[" end="]" -## Characters +# Characters color brightred "\\\(.." color brightred start="\\\[" end="]" -## Macro arguments +# Macro arguments color brightcyan "\\\\\$[1-9]" diff --git a/doc/syntax/html.nanorc b/doc/syntax/html.nanorc index c94bfec9..8782dc36 100644 --- a/doc/syntax/html.nanorc +++ b/doc/syntax/html.nanorc @@ -1,6 +1,8 @@ ## Here is a short example for HTML. -## -syntax "html" "\.html$" + +syntax "html" "\.html?$" magic "HTML document text" -color blue start="<" end=">" -color red "&[^;[[:space:]]]*;" + +color cyan start="<" end=">" +color red "&[^;[:space:]]*;" +color green ""(\\.|[^"])*"" diff --git a/doc/syntax/java.nanorc b/doc/syntax/java.nanorc index f45b0c94..0beebf47 100644 --- a/doc/syntax/java.nanorc +++ b/doc/syntax/java.nanorc @@ -1,7 +1,8 @@ ## Here is an example for Java. -## + syntax "java" "\.java$" magic "Java " + color green "\<(boolean|byte|char|double|float|int|long|new|short|this|transient|void)\>" color red "\<(break|case|catch|continue|default|do|else|finally|for|if|return|switch|throw|try|while)\>" color cyan "\<(abstract|class|extends|final|implements|import|instanceof|interface|native|package|private|protected|public|static|strictfp|super|synchronized|throws|volatile)\>" diff --git a/doc/syntax/javascript.nanorc b/doc/syntax/javascript.nanorc new file mode 100644 index 00000000..991f54bf --- /dev/null +++ b/doc/syntax/javascript.nanorc @@ -0,0 +1,19 @@ +## Here is an example for Javascript. + +syntax "javascript" "\.js$" + +color brightred "\<[A-Z_][0-9A-Z_]+\>" +color green "\<(const|function|let|this|typeof|var|void)\>" +color brightyellow "\<(for|if|while|with|do|else|case|default|switch)\>" +color brightyellow "\<(export|try|throw|catch|new|delete)\>" +color magenta "\<(continue|break|return|yield)\>" +color brightmagenta "'([^'\]|(\\["'abfnrtv\\]))'" "'\\(([0-3]?[0-7]{1,2}))'" "'\\x[0-9A-Fa-f]{1,2}'" + +# Strings. +color brightyellow "<[^= ]*>" ""(\\.|[^"])*"" "'(\\.|[^'])*'" +# Comments. +color brightblue "//.*" +color brightblue start="/\*" end="\*/" + +# Trailing whitespace. +color ,green "[[:space:]]+$" diff --git a/doc/syntax/json.nanorc b/doc/syntax/json.nanorc new file mode 100644 index 00000000..0f799f16 --- /dev/null +++ b/doc/syntax/json.nanorc @@ -0,0 +1,32 @@ +## Syntax highlighting for JSON files. + +# See: http://www.json.org/ +# Original author: Aapo Rantalainen +# License: GPLv3 or newer + +syntax "json" "\.json$" + +# Numbers (used as value). +color green ":[[:space:]]*\-?(0|[1-9][0-9]*)(\.[0-9]+)?([Ee]?[-+]?[0-9]+)?" +# Values (well, any string). +color brightmagenta "\".+\"" +# Hex numbers (used as value). +color green ":[[:space:]]*\"#[0-9abcdefABCDEF]+\"" +# Escapes. +color green "\\\\" "\\\"" "\\[bfnrt]" "\\u[0-9abcdefABCDEF]{4})" +# Special words. +color green "(true|false|null)" + +# Names (very unlikely to contain a quote). +color brightblue "\"[^"]+\"[[:space:]]*:" + +# Brackets, braces, and separators. +color brightblue "\[" "\]" +color brightred "\{" "\}" +color brightred "," ":" + +# Comments. +color cyan "(^|[[:space:]]+)(//|#).*$" + +# Trailing whitespace. +color ,green "[[:space:]]+$" diff --git a/doc/syntax/lua.nanorc b/doc/syntax/lua.nanorc index af9d1402..7512f53c 100644 --- a/doc/syntax/lua.nanorc +++ b/doc/syntax/lua.nanorc @@ -1,17 +1,9 @@ -############################################################################## +## Syntax highlighting for Lua. # -# Lua syntax highlighting for Nano. -# -# Author: Matthew Wild <mwild1 (at) gmail.com> -# License: GPL 3 or later -# -# Version: 2011-05-05 -# -# Notes: Originally based on Ruby syntax rc by Josef 'Jupp' Schugt -############################################################################## +## Author: Matthew Wild <mwild1 (at) gmail.com> +## License: GPL 3 or later +## Version: 2011-05-05 - -# Automatically use for '.lua' files syntax "lua" "\.lua$" color brightwhite "\[\[.*\]\]" @@ -51,7 +43,6 @@ color red "\<([0-9]+)\>" # Symbols color brightmagenta "(\(|\)|\[|\]|\{|\})" - # Shebang color brightcyan "^#!.*" @@ -62,15 +53,8 @@ color green "\-\-.*$" color green start="\-\-\[\[" end="\]\]" # Strings -#color green "\"(\\.|[^\\\"])*\"|'(\\.|[^\\'])*'" - -# Strings color red "\"(\\.|[^\\\"])*\"|'(\\.|[^\\'])*'" - -# color red start="\[\[" end="\]\]" - +##color red start="\[\[" end="\]\]" # Hex literals color red "0x[0-9a-fA-F]*" - - diff --git a/doc/syntax/makefile.nanorc b/doc/syntax/makefile.nanorc index 93a1e76d..04163909 100644 --- a/doc/syntax/makefile.nanorc +++ b/doc/syntax/makefile.nanorc @@ -1,8 +1,12 @@ -# unattributed syntax highlighting example from wiki.linuxhelp.net/ +## Here is an example for Makefiles. syntax "makefile" "Makefile[^/]*$" + color red "[:=]" color magenta "\<(if|ifeq|else|endif)\>" color blue "\$+[{(][a-zA-Z0-9_-]+[})]" color brightblue "^[^ ]+:" color green "#.*$" + +## Trailing whitespace. +color ,green "[[:space:]]+$" diff --git a/doc/syntax/man.nanorc b/doc/syntax/man.nanorc index 0dfa6feb..6c296bb6 100644 --- a/doc/syntax/man.nanorc +++ b/doc/syntax/man.nanorc @@ -1,10 +1,17 @@ ## Here is an example for manpages. -## + syntax "man" "\.[1-9]x?$" magic "troff or preprocessor input text" -color green "\.(S|T)H.*$" -color brightgreen "\.(S|T)H" "\.TP" -color brightred "\.(BR?|I[PR]?).*$" -color brightblue "\.(BR?|I[PR]?|PP)" -color brightwhite "\\f[BIPR]" -color yellow "\.(br|DS|RS|RE|PD)" + +color green "\.(SH|SS|TH) .*$" +color brightgreen "\.(SH|SS|TH) " "\.([HIT]P)" +color brightred "\.(B[IR]?|I[BR]?|R[BI]|S[BM]) .*$" +color brightblue "\.(B[IR]?|I[BR]?|R[BI]|S[BM]) " "\.([LP]?P)$" +color magenta "\\f[BIPR]" +color yellow "\.(br|DT|RS|RE|PD)" + +# Comments. +color cyan "\.?\\\".*$" + +# Trailing whitespace. +color ,green "[[:space:]]+$" diff --git a/doc/syntax/mgp.nanorc b/doc/syntax/mgp.nanorc index daba2827..c0a5d203 100644 --- a/doc/syntax/mgp.nanorc +++ b/doc/syntax/mgp.nanorc @@ -1,7 +1,8 @@ -## Here is an example for Magicpoint presentations -## +## Here is an example for Magicpoint presentations. + syntax "mgp" "\.mgp$" header "^%include.*" + icolor green "^%[a-z].*$" color cyan "(^|[[:space:]])#.*$" color cyan "(^|[[:space:]])%%.*$" diff --git a/doc/syntax/mutt.nanorc b/doc/syntax/mutt.nanorc index 2e683998..80fbcf46 100644 --- a/doc/syntax/mutt.nanorc +++ b/doc/syntax/mutt.nanorc @@ -1,4 +1,9 @@ ## Here is an example for quoted emails (under e.g. mutt). -## + syntax "mutt" + +# Quoted lines. color green "^>.*" + +# Signatures, even quoted ones. +color yellow start="^>* ?-- $" end="^>* ?$" diff --git a/doc/syntax/nanorc.nanorc b/doc/syntax/nanorc.nanorc index 2c9f23a4..730b939f 100644 --- a/doc/syntax/nanorc.nanorc +++ b/doc/syntax/nanorc.nanorc @@ -1,16 +1,28 @@ ## Here is an example for nanorc files. -## + syntax "nanorc" "\.?nanorc$" -## Possible errors and parameters -icolor brightwhite "^[[:space:]]*((un)?set|include|syntax|i?color).*$" -## Keywords -icolor brightgreen "^[[:space:]]*(set|unset)[[:space:]]+(allow_insecure_backup|autoindent|backup|backupdir|backwards|boldtext|brackets|casesensitive|const|cut|fill|historylog|matchbrackets|morespace|mouse|multibuffer|noconvert|nofollow|nohelp|nonewlines|nowrap|operatingdir|poslog|preserve|punct)\>" "^[[:space:]]*(set|unset)[[:space:]]+(quickblank|quotestr|rebinddelete|rebindkeypad|regexp|smarthome|smooth|softwrap|speller|suspend|suspendenable|tabsize|tabstospaces|tempfile|undo|view|whitespace|wordbounds|locking)\>" -icolor green "^[[:space:]]*(set|unset|include|syntax|header|magic)\>" -## Colors + +# Possible errors and parameters +icolor brightred "^[[:space:]]*((un)?(bind|set)|include|syntax|header|magic|linter|i?color|extendsyntax).*$" + +# Keywords +icolor brightgreen "^[[:space:]]*(set|unset)[[:space:]]+(allow_insecure_backup|autoindent|backup|backwards|boldtext|casesensitive|const|cut|fill|historylog|locking|morespace|mouse|multibuffer|noconvert|nofollow|nohelp|nonewlines|nowrap|poslog|preserve|quickblank|quiet|rebinddelete|rebindkeypad|regexp|smarthome|smooth|softwrap|suspend|tabsize|tabstospaces|tempfile|undo|view|wordbounds)\>" +icolor yellow "^[[:space:]]*set[[:space:]]+(functioncolor|keycolor||statuscolor|titlecolor)[[:space:]]+(bright)?(white|black|red|blue|green|yellow|magenta|cyan)?(,(white|black|red|blue|green|yellow|magenta|cyan))?\>" +icolor brightgreen "^[[:space:]]*set[[:space:]]+(backupdir|brackets|functioncolor|keycolor|matchbrackets|operatingdir|punct|quotestr|speller|statuscolor|titlecolor|whitespace)[[:space:]]+" +icolor brightgreen "^[[:space:]]*bind[[:space:]]+((\^|M-)([[:alpha:]]|space|[]]|[0-9_=+{}|;:'\",./<>\?-])|F([1-9]|1[0-6]))[[:space:]]+[[:alpha:]]+[[:space:]]+[[:alpha:]]+[[:space:]]*$" +icolor brightgreen "^[[:space:]]*unbind[[:space:]]+((\^|M-)([[:alpha:]]|space|[]]|[0-9_=+{}|;:'\",./<>\?-])|F([1-9]|1[0-6]))[[:space:]]+[[:alpha:]]+[[:space:]]*$" +icolor brightgreen "^[[:space:]]*extendsyntax[[:space:]]+[[:alpha:]]+[[:space:]]+(i?color|header|magic|linter)[[:space:]]+.*$" +icolor green "^[[:space:]]*((un)?(bind|set)|include|syntax|header|magic|linter|extendsyntax)\>" + +# Colors icolor yellow "^[[:space:]]*i?color[[:space:]]*(bright)?(white|black|red|blue|green|yellow|magenta|cyan)?(,(white|black|red|blue|green|yellow|magenta|cyan))?\>" icolor magenta "^[[:space:]]*i?color\>" "\<(start|end)=" -## Strings -icolor white ""(\\.|[^"])*"" -## Comments + +# Strings +icolor brightmagenta ""(\\.|[^"])*"" +# Comments icolor brightblue "^[[:space:]]*#.*$" icolor cyan "^[[:space:]]*##.*$" + +# Trailing whitespace +color ,green "[[:space:]]+$" diff --git a/doc/syntax/objc.nanorc b/doc/syntax/objc.nanorc index cdf6e485..bfbae126 100644 --- a/doc/syntax/objc.nanorc +++ b/doc/syntax/objc.nanorc @@ -1,10 +1,9 @@ ## Here is an example for C/C++/Obj-C. -## -syntax "m" "\.m$" +syntax "m" "\.m$" -## Stuffs -color brightwhite "\<[A-Z_][0-9A-Z_]+\>" +# Stuffs, +color brightwhite "\<[A-Z_][0-9A-Z_]+\>" color green "\<(float|double|BOOL|bool|char|int|short|long|id|sizeof|enum|void|static|const|struct|union|typedef|extern|(un)?signed|inline)\>" color green "\<[[:alpha:]_][[:alnum:]_]*_t\>" color green "\<(class|namespace|template|public|protected|private|typename|this|friend|virtual|using|mutable|volatile|register|explicit)\>" @@ -12,30 +11,29 @@ color brightgreen "\<(for|if|while|do|else|case|default|switch)\>" color brightgreen "\<(try|throw|catch|operator|new|delete)\>" color brightgreen "\<(goto|continue|break|return)\>" color brightgreen "@\<(en(code|d)|i(mplementation|nterface)|selector)\>" -## -## GCC builtins + +# GCC builtins. color cyan "__attribute__[[:space:]]*\(\([^)]*\)\)" "__(aligned|asm|builtin|hidden|inline|packed|restrict|section|typeof|weak)__" -## Selector/method +# Selector/method. color brightmagenta "(^|[[:space:]])\[.*[[:space:]].*\]" color white ":[[:alnum:]]*" color magenta "[[:alnum:]]*:" color white "\[[^][:space:]]*\]" -## -## String highlighting. You will in general want your comments and -## strings to come last, because syntax highlighting rules will be -## applied in the order they are read in. +# Strings. color brightblack "'([^'\]|(\\["'abfnrtv\\]))'" "'\\(([0-3]?[0-7]{1,2}))'" "'\\x[0-9A-Fa-f]{1,2}'" color brightblack "<[^= ]*>" ""(\\.|[^"])*"" color brightblue "@"(\\.|[^"])*"" -## -## This string is VERY resource intensive! +# Multiline strings. This regex is VERY resource intensive! ## color brightyellow start=""(\\.|[^"])*\\[[:space:]]*$" end="^(\\.|[^"])*"" +# Preprocessor commands. color brightblue "^[[:space:]]*#[[:space:]]*(define|include|import|(un|ifn?)def|endif|el(if|se)|if|warning|error)" -## Comment highlighting +# Comments. color yellow "//.*" color yellow start="/\*" end="\*/" +# Trailing whitespace. +color ,green "[[:space:]]+$" diff --git a/doc/syntax/ocaml.nanorc b/doc/syntax/ocaml.nanorc index fc71ae23..8decb727 100644 --- a/doc/syntax/ocaml.nanorc +++ b/doc/syntax/ocaml.nanorc @@ -1,6 +1,7 @@ -# OCaml sample nanorc -# +## Syntax highlighting for OCaml. + syntax "ocaml" "\.mli?$" + #uid color red "\<[A-Z][0-9a-z_]{2,}\>" #declarations @@ -10,7 +11,7 @@ color red "\<(type|open|class|module|exception|external)\>" #patterns color blue "\<(fun|function|functor|match|try|with)\>" #patterns-modifiers -color yellow "\<(as|when|of)\>" +color yellow "\<(as|when|of)\>" #conditions color cyan "\<(if|then|else)\>" #blocs diff --git a/doc/syntax/patch.nanorc b/doc/syntax/patch.nanorc index 5f101186..f5c1dd59 100644 --- a/doc/syntax/patch.nanorc +++ b/doc/syntax/patch.nanorc @@ -1,11 +1,21 @@ ## Here is an example for patch files. -## + syntax "patch" "\.(patch|diff)$" magic "diff output text" + +# Added lines. color brightgreen "^\+.*" -color green "^\+\+\+.*" +# Show trailing whitespace only on added lines. +color ,green "[[:space:]]+$" +# Context lines. color brightblue "^ .*" +# Deleted lines. color brightred "^-.*" + +# File names and dates. color red "^---.*" +color green "^\+\+\+.*" +# Line numbers. color brightyellow "^@@.*" +# Header lines. color magenta "^diff.*" diff --git a/doc/syntax/perl.nanorc b/doc/syntax/perl.nanorc index 21acb145..5f39c176 100644 --- a/doc/syntax/perl.nanorc +++ b/doc/syntax/perl.nanorc @@ -1,8 +1,9 @@ ## Here is an example for Perl. -## + syntax "perl" "\.p[lm]$" -magic "perl.*script text" header "^#!.*/perl[-0-9._]*" +magic "Perl script text" + color red "\<(accept|alarm|atan2|bin(d|mode)|c(aller|h(dir|mod|op|own|root)|lose(dir)?|onnect|os|rypt)|d(bm(close|open)|efined|elete|ie|o|ump)|e(ach|of|val|x(ec|ists|it|p))|f(cntl|ileno|lock|ork))\>" "\<(get(c|login|peername|pgrp|ppid|priority|pwnam|(host|net|proto|serv)byname|pwuid|grgid|(host|net)byaddr|protobynumber|servbyport)|([gs]et|end)(pw|gr|host|net|proto|serv)ent|getsock(name|opt)|gmtime|goto|grep|hex|index|int|ioctl|join)\>" "\<(keys|kill|last|length|link|listen|local(time)?|log|lstat|m|mkdir|msg(ctl|get|snd|rcv)|next|oct|open(dir)?|ord|pack|pipe|pop|printf?|push|q|qq|qx|rand|re(ad(dir|link)?|cv|do|name|quire|set|turn|verse|winddir)|rindex|rmdir|s|scalar|seek(dir)?)\>" "\<(se(lect|mctl|mget|mop|nd|tpgrp|tpriority|tsockopt)|shift|shm(ctl|get|read|write)|shutdown|sin|sleep|socket(pair)?|sort|spli(ce|t)|sprintf|sqrt|srand|stat|study|substr|symlink|sys(call|read|tem|write)|tell(dir)?|time|tr(y)?|truncate|umask)\>" "\<(un(def|link|pack|shift)|utime|values|vec|wait(pid)?|wantarray|warn|write)\>" color magenta "\<(continue|else|elsif|do|for|foreach|if|unless|until|while|eq|ne|lt|gt|le|ge|cmp|x|my|sub|use|package|can|isa)\>" icolor cyan start="[$@%]" end="( |[^0-9A-Z_]|-)" diff --git a/doc/syntax/php.nanorc b/doc/syntax/php.nanorc index 9cf54412..e3c4f1fa 100644 --- a/doc/syntax/php.nanorc +++ b/doc/syntax/php.nanorc @@ -1,31 +1,31 @@ -## Here is an example for PHP -## +## Here is an example for PHP. + syntax "php" "\.php[2345s~]?$" magic "PHP script text" -## php markings +# PHP markings. color brightgreen "(<\?(php)?|\?>)" -## functions +# Functions. color white "\<[a-z_]*\(" -## types +# Types. color green "\<(var|float|global|double|bool|char|int|enum|const)\>" -## structure +# Structure. color brightyellow "\<(class|new|private|public|function|for|foreach|if|while|do|else|elseif|case|default|switch)\>" -## control flow +# Control flow. color magenta "\<(goto|continue|break|return)\>" -## strings +# Strings. color brightyellow "<[^= ]*>" ""(\.|[^"])*"" -## comments +# Comments. color brightblue "//.*" color brightblue start="/\*" end="\*/" -#color blue start="<" end=">" -#color red "&[^;[[:space:]]]*;" +##color blue start="<" end=">" +##color red "&[^;[[:space:]]]*;" -## Trailing whitespace +# Trailing whitespace. color ,green "[[:space:]]+$" diff --git a/doc/syntax/po.nanorc b/doc/syntax/po.nanorc new file mode 100644 index 00000000..567ef7ad --- /dev/null +++ b/doc/syntax/po.nanorc @@ -0,0 +1,27 @@ +## Colouring for PO files. + +syntax "po" "\.pot?$" + +# Comments. +color green "^#.*$" +color yellow "Copyright|\(C\)" +# Header fields. +color brightmagenta "\<(Project\-Id\-Version|Report\-Msgid\-Bugs\-To|Last\-Translator|Language\-Team|Language|X\-Generator|Plural\-Forms)\>" +color cyan "\<(POT\-Creation\-Date|PO\-Revision\-Date|MIME\-Version|Content\-Type|Content\-Transfer\-Encoding)\>" +# Encodings and numbers. +color yellow "\<(UTF|ISO|Windows|Mac|IBM)\>\-[0-9]" +color yellow "[0-9]|pre[0-9]|[0-9]bit" +# Msgids. +color brightblue "\<(msgid|msgid_plural|msgstr)\>" +# Tags. +color red "\<fuzzy\>" +color yellow "\<c-format\>" +# Format specifiers. +color brightmagenta "%([1-9]\$)?[a-z]*" +# Quotes and newlines. +color yellow "\"" +color cyan "\\n" +# Reminders. +color ,yellow "(FIXME|TODO|XXX)" +# Obsolete strings. +color red "#~.*$" diff --git a/doc/syntax/pov.nanorc b/doc/syntax/pov.nanorc index 298b2012..b7033b10 100644 --- a/doc/syntax/pov.nanorc +++ b/doc/syntax/pov.nanorc @@ -1,6 +1,7 @@ ## Here is an example for POV-Ray. -## + syntax "pov" "\.(pov|POV|povray|POVRAY)$" + color brightcyan "^[[:space:]]*#[[:space:]]*(declare)" color brightyellow "\<(sphere|cylinder|translate|matrix|rotate|scale)\>" color brightyellow "\<(orthographic|location|up|right|direction|clipped_by)\>" @@ -10,6 +11,7 @@ color brightred "\<(light_source|background)\>" color brightred "\<(fog|object|camera)\>" color green "(\{|\}|\(|\)|\;|\]|\[|`|\\|\$|<|>|!|=|&|\|)" color brightmagenta "\<(union|group|subgroup)\>" -## Comment highlighting + +# Comments. color brightblue "//.*" color brightblue start="/\*" end="\*/" diff --git a/doc/syntax/python.nanorc b/doc/syntax/python.nanorc index 42802749..4679cf10 100644 --- a/doc/syntax/python.nanorc +++ b/doc/syntax/python.nanorc @@ -1,10 +1,24 @@ ## Here is an example for Python. -## + syntax "python" "\.py$" header "^#!.*/python[-0-9._]*" + +# Function definitions. icolor brightblue "def [0-9A-Z_]+" +# Keywords. color brightcyan "\<(and|as|assert|break|class|continue|def|del|elif|else|except|exec|finally|for|from|global|if|import|in|is|lambda|not|or|pass|print|raise|return|try|while|with|yield)\>" + +# Strings. color brightgreen "['][^']*[^\\][']" "[']{3}.*[^\\][']{3}" color brightgreen "["][^"]*[^\\]["]" "["]{3}.*[^\\]["]{3}" -color brightgreen start=""""[^"]" end=""""" start="'''[^']" end="'''" -color brightred "#.*$" +# Multiline strings. +color brightgreen start="\"\"\"([^"),]|$)" end="(^|[^(])\"\"\"" +color brightgreen start="'''([^'),]|$)" end="(^|[^(])'''" + +# Comments. +color brightred "(^|[[:blank:]])#.*$" +# Reminders. +color ,yellow "(FIXME|TODO|XXX)" + +# Trailing whitespace. +color ,green "[[:space:]]+$" diff --git a/doc/syntax/ruby.nanorc b/doc/syntax/ruby.nanorc index b30b229d..3566e1fe 100644 --- a/doc/syntax/ruby.nanorc +++ b/doc/syntax/ruby.nanorc @@ -1,31 +1,32 @@ ## Here is an example for Ruby. -## + syntax "ruby" "\.rb$" header "^#!.*/ruby[-0-9._]*" -## Asciibetical list of reserved words + +# Asciibetical list of reserved words. color yellow "\<(BEGIN|END|alias|and|begin|break|case|class|def|defined\?|do|else|elsif|end|ensure|false|for|if|in|module|next|nil|not|or|redo|rescue|retry|return|self|super|then|true|undef|unless|until|when|while|yield)\>" -## Constants +# Constants. color brightblue "(\$|@|@@)?\<[A-Z]+[0-9A-Z_a-z]*" -## Ruby "symbols" +# Ruby "symbols". icolor magenta "([ ]|^):[0-9A-Z_]+\>" -## Some unique things we want to stand out +# Some unique things we want to stand out. color brightyellow "\<(__FILE__|__LINE__)\>" -## Regular expressions +# Regular expressions. color brightmagenta "/([^/]|(\\/))*/[iomx]*" "%r\{([^}]|(\\}))*\}[iomx]*" -## Shell command expansion is in `backticks` or like %x{this}. These are -## "double-quotish" (to use a perlism). +# Shell command expansion is in `backticks` or like %x{this}. These are +# "double-quotish" (to use a perlism). color brightblue "`[^`]*`" "%x\{[^}]*\}" -## Strings, double-quoted +# Strings, double-quoted. color green ""([^"]|(\\"))*"" "%[QW]?\{[^}]*\}" "%[QW]?\([^)]*\)" "%[QW]?<[^>]*>" "%[QW]?\[[^]]*\]" "%[QW]?\$[^$]*\$" "%[QW]?\^[^^]*\^" "%[QW]?![^!]*!" -## Expression substitution. These go inside double-quoted strings, -## "like #{this}". +# Expression substitution. These go inside double-quoted strings, +# "like #{this}". color brightgreen "#\{[^}]*\}" -## Strings, single-quoted +# Strings, single-quoted. color green "'([^']|(\\'))*'" "%[qw]\{[^}]*\}" "%[qw]\([^)]*\)" "%[qw]<[^>]*>" "%[qw]\[[^]]*\]" "%[qw]\$[^$]*\$" "%[qw]\^[^^]*\^" "%[qw]![^!]*!" -## Comments +# Comments. color cyan "#[^{].*$" "#$" color brightcyan "##[^{].*$" "##$" -## "Here" docs +# "Here" docs. color green start="<<-?'?EOT'?" end="^EOT" -## Some common markers +# Some common markers. color brightcyan "(XXX|TODO|FIXME|\?\?\?)" diff --git a/doc/syntax/sh.nanorc b/doc/syntax/sh.nanorc index f6601057..823cc5d1 100644 --- a/doc/syntax/sh.nanorc +++ b/doc/syntax/sh.nanorc @@ -1,15 +1,27 @@ ## Here is an example for Bourne shell scripts. -## + syntax "sh" "\.sh$" -magic "(POSIX|Bourne.*) shell script text" header "^#!.*/(ba|k|pdk)?sh[-0-9_]*" +magic "(POSIX|Bourne.*) shell script text" + icolor brightgreen "^[0-9A-Z_]+\(\)" -color green "\<(case|do|done|elif|else|esac|exit|fi|for|function|if|in|local|read|return|select|shift|then|time|until|while)\>" -color green "(\{|\}|\(|\)|\;|\]|\[|`|\\|\$|<|>|!|=|&|\|)" +color green "\<(break|case|continue|do|done|elif|else|esac|exit|fi|for|function|if|in|read|return|select|shift|then|time|until|while)\>" +color green "\<(declare|eval|exec|export|let|local)\>" +color green "[{}():;|`$<>!=&\\]" "(\]|\[)" color green "-[Ldefgruwx]\>" color green "-(eq|ne|gt|lt|ge|le|s|n|z)\>" -color brightblue "\<(cat|cd|chmod|chown|cp|echo|env|export|grep|install|let|ln|make|mkdir|mv|rm|sed|set|tar|touch|umask|unset)\>" -icolor brightred "\$\{?[0-9A-Z_!@#$*?-]+\}?" +color brightblue "\<(awk|cat|cd|ch(grp|mod|own)|cp|echo|env|grep|install|ln|make|mkdir|mv|popd|printf|pushd|rm|rmdir|sed|set|tar|touch|umask|unset)\>" + +# Basic variable names (no braces). +color brightred "\$[-0-9@*#?$!]" "\$[[:alpha:]_][[:alnum:]_]*" +# More complicated variable names; handles braces and replacements and arrays. +color brightred "\$\{[#!]?([-@*#?$!]|[0-9]+|[[:alpha:]_][[:alnum:]_]*)(\[([[:space:]]*[[:alnum:]_]+[[:space:]]*|@)\])?(([#%/]|:?[-=?+])[^}]*\}|\[|\})" + +# Comments. color cyan "(^|[[:space:]])#.*$" + +# Strings. color brightyellow ""(\\.|[^"])*"" "'(\\.|[^'])*'" + +# Trailing whitespace. color ,green "[[:space:]]+$" diff --git a/doc/syntax/spec.nanorc b/doc/syntax/spec.nanorc index f4afb1b3..a0fff88a 100644 --- a/doc/syntax/spec.nanorc +++ b/doc/syntax/spec.nanorc @@ -1,8 +1,8 @@ -# RPM spec files syntax highlighting -# Parts taken from kate (KDE) syntax highlighting -# Asterios Dramis +## Syntax highlighting for RPM spec files. + syntax "spec" "\.(spec$|spec\.*)" -# Main tags + +# Main tags. color brightblue "((Icon|ExclusiveOs|ExcludeOs)[[:space:]]*:)" color brightblue "((BuildArch|BuildArchitectures|ExclusiveArch|ExcludeArch)[[:space:]]*:)" color brightblue "((Conflicts|Obsoletes|Provides|Requires|Requires\(.*\)|Enhances|Suggests|BuildConflicts|BuildRequires|Recommends|PreReq|Supplements)[[:space:]]*:)" @@ -11,28 +11,29 @@ color brightblue "((AutoReq|AutoProv|AutoReqProv)[[:space:]]*:)" color brightblue "((Copyright|License|Summary|Summary\(.*\)|Distribution|Vendor|Packager|Group|Source\d*|Patch\d*|BuildRoot|Prefix)[[:space:]]*:)" color brightblue "((Name|Version|Release|Url|URL)[[:space:]]*:)" color brightblue start="^Source" end=":" start="^Patch" end=":" -# Architectures +# Architectures. color brightred "(i386|i486|i586|i686|athlon|ia64|alpha|alphaev5|alphaev56|alphapca56|alphaev6|alphaev67|sparc|sparcv9|sparc64armv3l|armv4b|armv4lm|ips|mipsel|ppc|ppc|iseries|ppcpseries|ppc64|m68k|m68kmint|Sgi|rs6000|i370|s390x|s390|noarch)" -# Architectures conditionals +# Architecture conditionals. color brightred "(ifarch|ifnarch)" -# OS conditionals +# OS conditionals. color brightred "(ifos|ifnos)" -# %* strings +# %* strings. color green "%([A-Z_a-z_0-9_]*)" color magenta "%_([A-Z_a-z_0-9_]*)" color yellow start="%__" end="\ " color magenta start="%\{" end="\}" color yellow start="%\{__" end="\}" -# Sections +# Sections. color red "^%(build$|changelog|check$|clean$|description|files|install$|package|pre|prep$|preun|post|postun)" color red "^%(trigger|triggerin|triggerpostun|triggerun|verifyscript)" -# Conditionals and Defines +# Conditionals and defines. color brightred "%(if|else|endif|define|global|undefine)" -# Comments + +# Comments. color cyan "#.*$" -# "# norootforbuild" is handled as main tag +# Special case: "# norootforbuild" is handled as main tag. color brightblue "^# norootforbuild" -# %changelog date entries +# %changelog date entries. color brightyellow "^\* .*\)$" -# Trailing whitespace +# Trailing whitespace. color ,green "[[:space:]]+$" diff --git a/doc/syntax/tcl.nanorc b/doc/syntax/tcl.nanorc index ad3401fb..8bcec246 100644 --- a/doc/syntax/tcl.nanorc +++ b/doc/syntax/tcl.nanorc @@ -1,13 +1,15 @@ +## Syntax highlighting for Tcl files. + syntax "tcl" "\.tcl$" -## Standard Tcl [info commands] +# Standard Tcl [info commands]: color green "\<(after|append|array|auto_execok|auto_import|auto_load|auto_load_index|auto_qualify|binary|break|case|catch|cd|clock|close|concat|continue|encoding|eof|error|eval|exec|exit|expr|fblocked|fconfigure|fcopy|file|fileevent|flush|for|foreach|format|gets|glob|global|history|if|incr|info|interp|join|lappend|lindex|linsert|list|llength|load|lrange|lreplace|lsearch|lset|lsort|namespace|open|package|pid|puts|pwd|read|regexp|regsub|rename|return|scan|seek|set|socket|source|split|string|subst|switch|tclLog|tell|time|trace|unknown|unset|update|uplevel|upvar|variable|vwait|while)\>" -## Basic Tcl sub commands. +# Basic Tcl subcommands: color green "\<(array anymore|array donesearch|array exists|array get|array names|array nextelement|array set|array size|array startsearch|array statistics|array unset)\>" color green "\<(string bytelength|string compare|string equal|string first|string index|string is|string last|string length|string map|string match|string range|string repeat|string replace|string to|string tolower|string totitle|string toupper|string trim|string trimleft|string trimright|string will|string wordend|string wordstart)\>" -## Extended TclX [info commands] +# Extended TclX [info commands]: color green "\<(alarm|auto_load_pkg|bsearch|catclose|catgets|catopen|ccollate|cconcat|cequal|chgrp|chmod|chown|chroot|cindex|clength|cmdtrace|commandloop|crange|csubstr|ctoken|ctype|dup|echo|execl|fcntl|flock|fork|fstat|ftruncate|funlock|host_info|id|infox|keyldel|keylget|keylkeys|keylset|kill|lassign|lcontain|lempty|lgets|link|lmatch|loadlibindex|loop|lvarcat|lvarpop|lvarpush|max|min|nice|pipe|profile|random|readdir|replicate|scancontext|scanfile|scanmatch|select|server_accept|server_create|signal|sleep|sync|system|tclx_findinit|tclx_fork|tclx_load_tndxs|tclx_sleep|tclx_system|tclx_wait|times|translit|try_eval|umask|wait)\>" -## Syntax. +# Syntax: color brightblue "proc[[:space:]]" "(\{|\})" color green "(\(|\)|\;|`|\\|\$|<|>|!|=|&|\|)" color brightyellow ""(\\.|[^"])*"" "'(\\.|[^'])*'" diff --git a/doc/syntax/tex.nanorc b/doc/syntax/tex.nanorc index 23ca3a44..7fa417c4 100644 --- a/doc/syntax/tex.nanorc +++ b/doc/syntax/tex.nanorc @@ -1,6 +1,7 @@ ## Here is a short example for TeX files. -## + syntax "tex" "\.tex$" + icolor green "\\.|\\[A-Z]*" color magenta "[{}]" color blue "(^|[^\])%.*" diff --git a/doc/syntax/texinfo.nanorc b/doc/syntax/texinfo.nanorc new file mode 100644 index 00000000..63354bae --- /dev/null +++ b/doc/syntax/texinfo.nanorc @@ -0,0 +1,20 @@ +## Here is an example for Texinfo files. + +syntax "texinfo" "\.texi$" +header "^\\input texinfo" +magic "Texinfo source text" + +# Command arguments, trailing and enclosed. +color cyan "^@[a-z]+[[:space:]]+.*$" +color brightmagenta "@[a-z]+\{[^}]*\}" +# Commands themselves. +color yellow "@[a-z]+\{?" "\}" + +# Menu items. +color brightred "^\*[[:space:]]+.*::.*$" + +# Comments. +color green "@c[[:space:]]+.*$" + +# Trailing whitespace. +color ,green "[[:space:]]+$" diff --git a/doc/syntax/xml.nanorc b/doc/syntax/xml.nanorc index 9005d614..69982ea8 100644 --- a/doc/syntax/xml.nanorc +++ b/doc/syntax/xml.nanorc @@ -1,7 +1,8 @@ -## Here is an example for xml files. -## +## Here is an example for XML files. + syntax "xml" "\.([jrs]html?|sgml?|xml|xslt?)$" -magic "XML.*document text" +magic "(XML|SGML) (sub)?document text" + color green start="<" end=">" color cyan "<[^> ]+" color cyan ">" diff --git a/doc/texinfo/Makefile.in b/doc/texinfo/Makefile.in index 46df6bdf..41cb275c 100644 --- a/doc/texinfo/Makefile.in +++ b/doc/texinfo/Makefile.in @@ -1,9 +1,8 @@ -# Makefile.in generated by automake 1.11.6 from Makefile.am. +# Makefile.in generated by automake 1.13.3 from Makefile.am. # @configure_input@ -# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, -# 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software -# Foundation, Inc. +# Copyright (C) 1994-2013 Free Software Foundation, Inc. + # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, # with or without modifications, as long as this notice is preserved. @@ -15,23 +14,51 @@ @SET_MAKE@ VPATH = @srcdir@ -am__make_dryrun = \ - { \ - am__dry=no; \ +am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__make_running_with_option = \ + case $${target_option-} in \ + ?) ;; \ + *) echo "am__make_running_with_option: internal error: invalid" \ + "target option '$${target_option-}' specified" >&2; \ + exit 1;; \ + esac; \ + has_opt=no; \ + sane_makeflags=$$MAKEFLAGS; \ + if $(am__is_gnu_make); then \ + sane_makeflags=$$MFLAGS; \ + else \ case $$MAKEFLAGS in \ *\\[\ \ ]*) \ - echo 'am--echo: ; @echo "AM" OK' | $(MAKE) -f - 2>/dev/null \ - | grep '^AM OK$$' >/dev/null || am__dry=yes;; \ - *) \ - for am__flg in $$MAKEFLAGS; do \ - case $$am__flg in \ - *=*|--*) ;; \ - *n*) am__dry=yes; break;; \ - esac; \ - done;; \ + bs=\\; \ + sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \ + | sed "s/$$bs$$bs[$$bs $$bs ]*//g"`;; \ esac; \ - test $$am__dry = yes; \ - } + fi; \ + skip_next=no; \ + strip_trailopt () \ + { \ + flg=`printf '%s\n' "$$flg" | sed "s/$$1.*$$//"`; \ + }; \ + for flg in $$sane_makeflags; do \ + test $$skip_next = yes && { skip_next=no; continue; }; \ + case $$flg in \ + *=*|--*) continue;; \ + -*I) strip_trailopt 'I'; skip_next=yes;; \ + -*I?*) strip_trailopt 'I';; \ + -*O) strip_trailopt 'O'; skip_next=yes;; \ + -*O?*) strip_trailopt 'O';; \ + -*l) strip_trailopt 'l'; skip_next=yes;; \ + -*l?*) strip_trailopt 'l';; \ + -[dEDm]) skip_next=yes;; \ + -[JT]) skip_next=yes;; \ + esac; \ + case $$flg in \ + *$$target_option*) has_opt=yes; break;; \ + esac; \ + done; \ + test $$has_opt = yes +am__make_dryrun = (target_option=n; $(am__make_running_with_option)) +am__make_keepgoing = (target_option=k; $(am__make_running_with_option)) pkgdatadir = $(datadir)/@PACKAGE@ pkgincludedir = $(includedir)/@PACKAGE@ pkglibdir = $(libdir)/@PACKAGE@ @@ -51,9 +78,11 @@ POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ subdir = doc/texinfo -DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in texinfo.tex +DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ + $(top_srcdir)/mkinstalldirs texinfo.tex ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ac_define_dir.m4 \ + $(top_srcdir)/m4/ax_check_compile_flag.m4 \ $(top_srcdir)/m4/gettext.m4 $(top_srcdir)/m4/glib-2.0.m4 \ $(top_srcdir)/m4/iconv.m4 $(top_srcdir)/m4/isc-posix.m4 \ $(top_srcdir)/m4/lib-ld.m4 $(top_srcdir)/m4/lib-link.m4 \ @@ -65,8 +94,48 @@ mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs CONFIG_HEADER = $(top_builddir)/config.h CONFIG_CLEAN_FILES = CONFIG_CLEAN_VPATH_FILES = +AM_V_P = $(am__v_P_@AM_V@) +am__v_P_ = $(am__v_P_@AM_DEFAULT_V@) +am__v_P_0 = false +am__v_P_1 = : +AM_V_GEN = $(am__v_GEN_@AM_V@) +am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@) +am__v_GEN_0 = @echo " GEN " $@; +am__v_GEN_1 = +AM_V_at = $(am__v_at_@AM_V@) +am__v_at_ = $(am__v_at_@AM_DEFAULT_V@) +am__v_at_0 = @ +am__v_at_1 = SOURCES = DIST_SOURCES = +AM_V_DVIPS = $(am__v_DVIPS_@AM_V@) +am__v_DVIPS_ = $(am__v_DVIPS_@AM_DEFAULT_V@) +am__v_DVIPS_0 = @echo " DVIPS " $@; +am__v_DVIPS_1 = +AM_V_MAKEINFO = $(am__v_MAKEINFO_@AM_V@) +am__v_MAKEINFO_ = $(am__v_MAKEINFO_@AM_DEFAULT_V@) +am__v_MAKEINFO_0 = @echo " MAKEINFO" $@; +am__v_MAKEINFO_1 = +AM_V_INFOHTML = $(am__v_INFOHTML_@AM_V@) +am__v_INFOHTML_ = $(am__v_INFOHTML_@AM_DEFAULT_V@) +am__v_INFOHTML_0 = @echo " INFOHTML" $@; +am__v_INFOHTML_1 = +AM_V_TEXI2DVI = $(am__v_TEXI2DVI_@AM_V@) +am__v_TEXI2DVI_ = $(am__v_TEXI2DVI_@AM_DEFAULT_V@) +am__v_TEXI2DVI_0 = @echo " TEXI2DVI" $@; +am__v_TEXI2DVI_1 = +AM_V_TEXI2PDF = $(am__v_TEXI2PDF_@AM_V@) +am__v_TEXI2PDF_ = $(am__v_TEXI2PDF_@AM_DEFAULT_V@) +am__v_TEXI2PDF_0 = @echo " TEXI2PDF" $@; +am__v_TEXI2PDF_1 = +AM_V_texinfo = $(am__v_texinfo_@AM_V@) +am__v_texinfo_ = $(am__v_texinfo_@AM_DEFAULT_V@) +am__v_texinfo_0 = -q +am__v_texinfo_1 = +AM_V_texidevnull = $(am__v_texidevnull_@AM_V@) +am__v_texidevnull_ = $(am__v_texidevnull_@AM_DEFAULT_V@) +am__v_texidevnull_0 = > /dev/null +am__v_texidevnull_1 = INFO_DEPS = $(srcdir)/nano.info am__TEXINFO_TEX_DIR = $(srcdir) DVIS = nano.dvi @@ -112,9 +181,11 @@ am__uninstall_files_from_dir = { \ || { echo " ( cd '$$dir' && rm -f" $$files ")"; \ $(am__cd) "$$dir" && rm -f $$files; }; \ } +am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ AMTAR = @AMTAR@ +AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ @@ -160,7 +231,11 @@ MKDIR_P = @MKDIR_P@ MKINSTALLDIRS = @MKINSTALLDIRS@ MSGFMT = @MSGFMT@ MSGMERGE = @MSGMERGE@ +NCURSESW_CFLAGS = @NCURSESW_CFLAGS@ NCURSESW_CONFIG = @NCURSESW_CONFIG@ +NCURSESW_LIBS = @NCURSESW_LIBS@ +NCURSES_CFLAGS = @NCURSES_CFLAGS@ +NCURSES_LIBS = @NCURSES_LIBS@ OBJEXT = @OBJEXT@ PACKAGE = @PACKAGE@ PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ @@ -172,6 +247,8 @@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ PKGDATADIR = @PKGDATADIR@ PKG_CONFIG = @PKG_CONFIG@ +PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@ +PKG_CONFIG_PATH = @PKG_CONFIG_PATH@ POSUB = @POSUB@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ @@ -201,6 +278,7 @@ datarootdir = @datarootdir@ docdir = @docdir@ dvidir = @dvidir@ exec_prefix = @exec_prefix@ +haveit = @haveit@ host = @host@ host_alias = @host_alias@ host_cpu = @host_cpu@ @@ -269,7 +347,7 @@ $(ACLOCAL_M4): $(am__aclocal_m4_deps) $(am__aclocal_m4_deps): .texi.info: - restore=: && backupdir="$(am__leading_dot)am$$$$" && \ + $(AM_V_MAKEINFO)restore=: && backupdir="$(am__leading_dot)am$$$$" && \ am__cwd=`pwd` && $(am__cd) $(srcdir) && \ rm -rf $$backupdir && mkdir $$backupdir && \ if ($(MAKEINFO) --version) >/dev/null 2>&1; then \ @@ -291,18 +369,20 @@ $(am__aclocal_m4_deps): rm -rf $$backupdir; exit $$rc .texi.dvi: - TEXINPUTS="$(am__TEXINFO_TEX_DIR)$(PATH_SEPARATOR)$$TEXINPUTS" \ + $(AM_V_TEXI2DVI)TEXINPUTS="$(am__TEXINFO_TEX_DIR)$(PATH_SEPARATOR)$$TEXINPUTS" \ MAKEINFO='$(MAKEINFO) $(AM_MAKEINFOFLAGS) $(MAKEINFOFLAGS) -I $(srcdir)' \ - $(TEXI2DVI) $< + $(TEXI2DVI) $(AM_V_texinfo) --build-dir=$(@:.dvi=.t2d) -o $@ $(AM_V_texidevnull) \ + $< .texi.pdf: - TEXINPUTS="$(am__TEXINFO_TEX_DIR)$(PATH_SEPARATOR)$$TEXINPUTS" \ + $(AM_V_TEXI2PDF)TEXINPUTS="$(am__TEXINFO_TEX_DIR)$(PATH_SEPARATOR)$$TEXINPUTS" \ MAKEINFO='$(MAKEINFO) $(AM_MAKEINFOFLAGS) $(MAKEINFOFLAGS) -I $(srcdir)' \ - $(TEXI2PDF) $< + $(TEXI2PDF) $(AM_V_texinfo) --build-dir=$(@:.pdf=.t2p) -o $@ $(AM_V_texidevnull) \ + $< .texi.html: - rm -rf $(@:.html=.htp) - if $(MAKEINFOHTML) $(AM_MAKEINFOHTMLFLAGS) $(MAKEINFOFLAGS) -I $(srcdir) \ + $(AM_V_MAKEINFO)rm -rf $(@:.html=.htp) + $(AM_V_at)if $(MAKEINFOHTML) $(AM_MAKEINFOHTMLFLAGS) $(MAKEINFOFLAGS) -I $(srcdir) \ -o $(@:.html=.htp) $<; \ then \ rm -rf $@; \ @@ -317,8 +397,8 @@ $(srcdir)/nano.info: nano.texi nano.dvi: nano.texi nano.pdf: nano.texi .dvi.ps: - TEXINPUTS="$(am__TEXINFO_TEX_DIR)$(PATH_SEPARATOR)$$TEXINPUTS" \ - $(DVIPS) -o $@ $< + $(AM_V_DVIPS)TEXINPUTS="$(am__TEXINFO_TEX_DIR)$(PATH_SEPARATOR)$$TEXINPUTS" \ + $(DVIPS) $(AM_V_texinfo) -o $@ $< uninstall-dvi-am: @$(NORMAL_UNINSTALL) @@ -397,9 +477,7 @@ dist-info: $(INFO_DEPS) done mostlyclean-aminfo: - -rm -rf nano.aux nano.cp nano.cps nano.fn nano.fns nano.ky nano.kys \ - nano.log nano.pg nano.pgs nano.tmp nano.toc nano.tp nano.tps \ - nano.vr nano.vrs + -rm -rf nano.t2d nano.t2p clean-aminfo: -test -z "nano.dvi nano.pdf nano.ps nano.html" \ @@ -411,11 +489,11 @@ maintainer-clean-aminfo: echo " rm -f $$i $$i-[0-9] $$i-[0-9][0-9] $$i_i[0-9] $$i_i[0-9][0-9]"; \ rm -f $$i $$i-[0-9] $$i-[0-9][0-9] $$i_i[0-9] $$i_i[0-9][0-9]; \ done -tags: TAGS -TAGS: +tags TAGS: + +ctags CTAGS: -ctags: CTAGS -CTAGS: +cscope cscopelist: distdir: $(DISTFILES) @@ -653,16 +731,17 @@ uninstall-am: uninstall-dvi-am uninstall-html-am uninstall-info-am \ .MAKE: all check install install-am install-strip .PHONY: all all-am check check-am clean clean-aminfo clean-generic \ - dist-info distclean distclean-generic distdir dvi dvi-am html \ - html-am info info-am install install-am install-data \ - install-data-am install-dvi install-dvi-am install-exec \ - install-exec-am install-html install-html-am install-info \ - install-info-am install-man install-pdf install-pdf-am \ - install-ps install-ps-am install-strip installcheck \ - installcheck-am installdirs maintainer-clean \ - maintainer-clean-aminfo maintainer-clean-generic mostlyclean \ - mostlyclean-aminfo mostlyclean-generic pdf pdf-am ps ps-am \ - uninstall uninstall-am uninstall-dvi-am uninstall-html-am \ + cscopelist-am ctags-am dist-info distclean distclean-generic \ + distdir dvi dvi-am html html-am info info-am install \ + install-am install-data install-data-am install-dvi \ + install-dvi-am install-exec install-exec-am install-html \ + install-html-am install-info install-info-am install-man \ + install-pdf install-pdf-am install-ps install-ps-am \ + install-strip installcheck installcheck-am installdirs \ + maintainer-clean maintainer-clean-aminfo \ + maintainer-clean-generic mostlyclean mostlyclean-aminfo \ + mostlyclean-generic pdf pdf-am ps ps-am tags-am uninstall \ + uninstall-am uninstall-dvi-am uninstall-html-am \ uninstall-info-am uninstall-pdf-am uninstall-ps-am diff --git a/doc/texinfo/nano.html b/doc/texinfo/nano.html index b6735577..e68b9133 100644 --- a/doc/texinfo/nano.html +++ b/doc/texinfo/nano.html @@ -1,363 +1,542 @@ -<html lang="en"> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ --> <head> <title>nano Command Manual</title> -<meta http-equiv="Content-Type" content="text/html"> + <meta name="description" content="nano Command Manual"> -<meta name="generator" content="makeinfo 4.13"> -<link title="Top" rel="top" href="#Top"> -<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> -<meta http-equiv="Content-Style-Type" content="text/css"> -<style type="text/css"><!-- - pre.display { font-family:inherit } - pre.format { font-family:inherit } - pre.smalldisplay { font-family:inherit; font-size:smaller } - pre.smallformat { font-family:inherit; font-size:smaller } - pre.smallexample { font-size:smaller } - pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family:serif; font-weight:normal; } - span.sansserif { font-family:sans-serif; font-weight:normal; } ---></style> +<meta name="keywords" content="nano Command Manual"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<link href="#Top" rel="start" title="Top"> +<link href="#SEC_Contents" rel="contents" title="Table of Contents"> +<link href="dir.html#Top" rel="up" title="(dir)"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.smallquotation {font-size: smaller} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.indentedblock {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +div.smalldisplay {margin-left: 3.2em} +div.smallexample {margin-left: 3.2em} +div.smallindentedblock {margin-left: 3.2em; font-size: smaller} +div.smalllisp {margin-left: 3.2em} +kbd {font-style:oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +pre.smalldisplay {font-family: inherit; font-size: smaller} +pre.smallexample {font-size: smaller} +pre.smallformat {font-family: inherit; font-size: smaller} +pre.smalllisp {font-size: smaller} +span.nocodebreak {white-space:nowrap} +span.nolinebreak {white-space:nowrap} +span.roman {font-family:serif; font-weight:normal} +span.sansserif {font-family:sans-serif; font-weight:normal} +ul.no-bullet {list-style: none} +--> +</style> + + </head> -<body> -<h1 class="settitle">nano Command Manual</h1> -<div class="node"> -<a name="Top"></a> -<p><hr> -Next: <a rel="next" accesskey="n" href="#Introduction">Introduction</a>, -Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>, -Up: <a rel="up" accesskey="u" href="#dir">(dir)</a> -</div> +<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> +<h1 class="settitle" align="center">nano Command Manual</h1> - <p>This manual documents GNU <code>nano</code>, a small and friendly text -editor. -<ul class="menu"> -<li><a accesskey="1" href="#Introduction">Introduction</a> -<li><a accesskey="2" href="#Editor-Basics">Editor Basics</a> -<li><a accesskey="3" href="#Online-Help">Online Help</a> -<li><a accesskey="4" href="#Feature-Toggles">Feature Toggles</a> -<li><a accesskey="5" href="#Nanorc-Files">Nanorc Files</a> -<li><a accesskey="6" href="#The-File-Browser">The File Browser</a> -<li><a accesskey="7" href="#Pico-Compatibility">Pico Compatibility</a> -<li><a accesskey="8" href="#Building-and-Configure-Options">Building and Configure Options</a> -</ul> -<div class="node"> -<a name="Introduction"></a> -<p><hr> -Next: <a rel="next" accesskey="n" href="#Editor-Basics">Editor Basics</a>, -Previous: <a rel="previous" accesskey="p" href="#Top">Top</a>, -Up: <a rel="up" accesskey="u" href="#Top">Top</a> + + +<a name="Top"></a> +<div class="header"> +<p> +Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> </div> +<a name="SEC_Top"></a> +<p>This manual documents GNU <code>nano</code>, a small and friendly text +editor. +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Introduction" accesskey="1">Introduction</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#Editor-Basics" accesskey="2">Editor Basics</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#Online-Help" accesskey="3">Online Help</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#Feature-Toggles" accesskey="4">Feature Toggles</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#Nanorc-Files" accesskey="5">Nanorc Files</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#The-File-Browser" accesskey="6">The File Browser</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#Pico-Compatibility" accesskey="7">Pico Compatibility</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#Building-and-Configure-Options" accesskey="8">Building and Configure Options</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +</table> + + +<hr> +<a name="Introduction"></a> +<div class="header"> +<p> +Next: <a href="#Editor-Basics" accesskey="n" rel="next">Editor Basics</a>, Previous: <a href="#Top" accesskey="p" rel="previous">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<a name="Introduction-1"></a> <h2 class="chapter">1 Introduction</h2> <p>GNU <code>nano</code> is a small and friendly text editor. Besides basic text -editing, <code>nano</code> offers many extra features like an interactive -search and replace, go to line and column number, auto-indentation, +editing, <code>nano</code> offers many extra features, like an interactive +search-and-replace, go-to-line-and-column-number, auto-indentation, feature toggles, internationalization support, and filename tab completion. - -<ul class="menu"> -<li><a accesskey="1" href="#Overview">Overview</a> -<li><a accesskey="2" href="#Command-Line-Options">Command Line Options</a> -</ul> - -<div class="node"> +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Overview" accesskey="1">Overview</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#Command-Line-Options" accesskey="2">Command Line Options</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +</table> + +<hr> <a name="Overview"></a> -<p><hr> -Next: <a rel="next" accesskey="n" href="#Command-Line-Options">Command Line Options</a>, -Previous: <a rel="previous" accesskey="p" href="#Introduction">Introduction</a>, -Up: <a rel="up" accesskey="u" href="#Introduction">Introduction</a> - +<div class="header"> +<p> +Next: <a href="#Command-Line-Options" accesskey="n" rel="next">Command Line Options</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> </div> - +<a name="Overview-1"></a> <h3 class="section">1.1 Overview</h3> <p>The original goal for <code>nano</code> was a complete bug-for-bug compatible -emulation of Pico, but <code>nano</code>'s current goal is to be as compatible -as possible while offering a superset of Pico's functionality. See +emulation of Pico, but <code>nano</code>’s current goal is to be as compatible +as possible while offering a superset of Pico’s functionality. See See <a href="#Pico-Compatibility">Pico Compatibility</a>, for more info. - - <p>The usual way to invoke <code>nano</code> is: - - <blockquote> -<code>nano [OPTION]... [FILE]</code> -</blockquote> - - <p>But it is also possible to edit several files in a row. Additionally, +</p> +<p>The usual way to invoke <code>nano</code> is: +</p> +<blockquote> +<p><code>nano [OPTION]… [FILE]</code> +</p></blockquote> + +<p>But it is also possible to edit several files in a row. Additionally, the cursor can be put on a desired line number by adding this number with a plus sign before any filename, and even in a desired column by adding it with a comma. So the complete synopsis is: - - <blockquote> -<code>nano [OPTION]... [[+LINE] FILE]...</code> - - <p><code>nano [OPTION]... [[+,COLUMN] FILE]...</code> - - <p><code>nano [OPTION]... [[+LINE,COLUMN] FILE]...</code> -</blockquote> - - <p>Email bug reports to <a href="mailto:nano@nano-editor.org">nano@nano-editor.org</a>. - -<div class="node"> +</p> +<blockquote> +<p><code>nano [OPTION]… [[+LINE] FILE]…</code> +</p> +<p><code>nano [OPTION]… [[+,COLUMN] FILE]…</code> +</p> +<p><code>nano [OPTION]… [[+LINE,COLUMN] FILE]…</code> +</p></blockquote> + +<p>Email bug reports to <a href="mailto:nano@nano-editor.org">nano@nano-editor.org</a>. +</p> +<hr> <a name="Command-Line-Options"></a> -<p><hr> -Previous: <a rel="previous" accesskey="p" href="#Overview">Overview</a>, -Up: <a rel="up" accesskey="u" href="#Introduction">Introduction</a> - +<div class="header"> +<p> +Previous: <a href="#Overview" accesskey="p" rel="previous">Overview</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> </div> - +<a name="Command-Line-Options-1"></a> <h3 class="section">1.2 Command Line Options</h3> <p><code>nano</code> takes the following options from the command line: - - <dl> -<dt><code>+LINE,COLUMN</code><dd>Start at line number LINE and column number COLUMN (at least one of +</p> +<dl compact="compact"> +<dt><code>+<line>,<column></code></dt> +<dd><p>Start at line number <line> and column number <column> (at least one of which must be specified) instead of the default of line 1, column 1. - - <br><dt><code>-?</code><dd>Same as <code>-h, --help</code>. - - <br><dt><code>-A, --smarthome</code><dd>Make the Home key smarter. When Home is pressed anywhere but at the +</p> +</dd> +<dt><code>-A, --smarthome</code></dt> +<dd><p>Make the Home key smarter. When Home is pressed anywhere but at the very beginning of non-whitespace characters on a line, the cursor will jump to that beginning (either forwards or backwards). If the cursor is already at that position, it will jump to the true beginning of the line. - - <br><dt><code>-B, --backup</code><dd>When saving a file, back up the previous version of it to the current +</p> +</dd> +<dt><code>-B, --backup</code></dt> +<dd><p>When saving a file, back up the previous version of it to the current filename suffixed with a ~. - - <br><dt><code>-C <dir>, --backupdir=<dir></code><dd>Set the directory where <code>nano</code> puts unique backup files if file +</p> +</dd> +<dt><code>-C <dir>, --backupdir=<dir></code></dt> +<dd><p>Set the directory where <code>nano</code> puts unique backup files if file backups are enabled. - - <br><dt><code>-D, --boldtext</code><dd>Use bold text instead of reverse video text. - - <br><dt><code>-E, --tabstospaces</code><dd>Convert typed tabs to spaces. - - <br><dt><code>-F, --multibuffer</code><dd>Enable multiple file buffers, if available. - - <br><dt><code>-H, --historylog</code><dd>Log search and replace strings to ~/.nano_history, so they can be +</p> +</dd> +<dt><code>-D, --boldtext</code></dt> +<dd><p>Use bold text instead of reverse video text. +</p> +</dd> +<dt><code>-E, --tabstospaces</code></dt> +<dd><p>Convert typed tabs to spaces. +</p> +</dd> +<dt><code>-F, --multibuffer</code></dt> +<dd><p>Enable multiple file buffers, if available. +</p> +</dd> +<dt><code>-G, --locking</code></dt> +<dd><p>Enable vim-style file locking when editing files. +</p> +</dd> +<dt><code>-H, --historylog</code></dt> +<dd><p>Log search and replace strings to ~/.nano_history, so they can be retrieved in later sessions, if nanorc support is available. - - <br><dt><code>-I, --ignorercfiles</code><dd>Don't look at SYSCONFDIR/nanorc or ~/.nanorc, if nanorc support is +</p> +</dd> +<dt><code>-I, --ignorercfiles</code></dt> +<dd><p>Don’t look at SYSCONFDIR/nanorc or ~/.nanorc, if nanorc support is available. - - <br><dt><code>-K, --rebindkeypad</code><dd>Interpret the numeric keypad keys so that they all work properly. You -should only need to use this option if they don't, as mouse support -won't work properly with this option enabled. - - <br><dt><code>-L, --nonewlines</code><dd>Don't add newlines to the ends of files. - - <br><dt><code>-N, --noconvert</code><dd>Don't convert files from DOS/Mac format. - - <br><dt><code>-O, --morespace</code><dd>Use the blank line below the titlebar as extra editing space. - - <br><dt><code>-Q <str>, --quotestr=<str></code><dd>Set the quoting string for justifying. The default value is - - <blockquote> -<code>^([ \t]*[|>:}#])+</code> -</blockquote> - - <p>if extended regular expression support is available, or "> " otherwise. +</p> +</dd> +<dt><code>-K, --rebindkeypad</code></dt> +<dd><p>Interpret the numeric keypad keys so that they all work properly. You +should only need to use this option if they don’t, as mouse support +won’t work properly with this option enabled. +</p> +</dd> +<dt><code>-L, --nonewlines</code></dt> +<dd><p>Don’t add newlines to the ends of files. +</p> +</dd> +<dt><code>-N, --noconvert</code></dt> +<dd><p>Disable automatic conversion of files from DOS/Mac format. +</p> +</dd> +<dt><code>-O, --morespace</code></dt> +<dd><p>Use the blank line below the titlebar as extra editing space. +</p> +</dd> +<dt><code>-P, --poslog</code></dt> +<dd><p>Log and later read back the location of the cursor and place it +there again. +</p> +</dd> +<dt><code>-Q <str>, --quotestr=<str></code></dt> +<dd><p>Set the quoting string for justifying. The default value is +</p> +<blockquote> +<p><code>^([ \t]*[|>:}#])+</code> +</p></blockquote> + +<p>if extended regular expression support is available, or "> " otherwise. Note that <code>\t</code> above stands for a literal Tab character. - - <br><dt><code>-R, --restricted</code><dd>Restricted mode: don't read or write to any file not specified on the -command line; read any nanorc files; allow suspending; allow a file to -be appended to, prepended to, or saved under a different name if it -already has one; or use backup files or spell checking. Also accessible -by invoking <code>nano</code> with any name beginning with 'r' (e.g. "rnano"). - - <br><dt><code>-S, --smooth</code><dd>Enable smooth scrolling. Text will scroll line-by-line, instead of the +</p> +</dd> +<dt><code>-R, --restricted</code></dt> +<dd><p>Restricted mode: don’t read or write to any file not specified on the +command line; don’t read any nanorc files; don’t allow suspending; don’t +allow a file to be appended to, prepended to, or saved under a different +name if it already has one; don’t use backup files nor spell checking. +This restricted mode is also accessible by invoking <code>nano</code> with +any name beginning with ’r’ (e.g. "rnano"). +</p> +</dd> +<dt><code>-S, --smooth</code></dt> +<dd><p>Enable smooth scrolling. Text will scroll line-by-line, instead of the usual chunk-by-chunk behavior. - - <br><dt><code>-T <#cols>, --tabsize=<#cols></code><dd>Set the displayed tab length to #cols columns. The value of #cols must -be greater than 0. The default value is 8. - - <br><dt><code>-U, --quickblank</code><dd>Do quick statusbar blanking. Statusbar messages will disappear after 1 +</p> +</dd> +<dt><code>-T <number>, --tabsize=<number></code></dt> +<dd><p>Set the displayed tab length to <number> columns. The value of <number> +must be greater than 0. The default value is 8. +</p> +</dd> +<dt><code>-U, --quickblank</code></dt> +<dd><p>Do quick statusbar blanking. Statusbar messages will disappear after 1 keystroke instead of 25. Note that -c overrides this. - - <br><dt><code>-V, --version</code><dd>Show the current version number and exit. - - <br><dt><code>-W, --wordbounds</code><dd>Detect word boundaries more accurately by treating punctuation +</p> +</dd> +<dt><code>-V, --version</code></dt> +<dd><p>Show the current version number and exit. +</p> +</dd> +<dt><code>-W, --wordbounds</code></dt> +<dd><p>Detect word boundaries more accurately by treating punctuation characters as parts of words. - - <br><dt><code>-Y <str>, --syntax=<str></code><dd>Specify a specific syntax highlighting from the nanorc to use, if -available. See See <a href="#Nanorc-Files">Nanorc Files</a>, for more info. - - <br><dt><code>-c, --const</code><dd>Constantly display the cursor position and line number on the statusbar. +</p> +</dd> +<dt><code>-Y <str>, --syntax=<str></code></dt> +<dd><p>Specify a specific syntax from the nanorc to use for highlighting, if +available. See See <a href="#Syntax-Highlighting">Syntax Highlighting</a>, for more info. +</p> +</dd> +<dt><code>-c, --const</code></dt> +<dd><p>Constantly display the cursor position and line number on the statusbar. Note that this overrides -U. - - <br><dt><code>-d, --rebinddelete</code><dd>Interpret the Delete key differently so that both Backspace and Delete +</p> +</dd> +<dt><code>-d, --rebinddelete</code></dt> +<dd><p>Interpret the Delete key differently so that both Backspace and Delete work properly. You should only need to use this option if Backspace acts like Delete on your system. - - <br><dt><code>-h, --help</code><dd>Show a summary of command line options and exit. - - <br><dt><code>-i, --autoindent</code><dd>Automatically indent new lines to the same number of spaces and tabs as +</p> +</dd> +<dt><code>-h, --help</code></dt> +<dd><p>Show a summary of command-line options and exit. +</p> +</dd> +<dt><code>-i, --autoindent</code></dt> +<dd><p>Automatically indent new lines to the same number of spaces and tabs as the previous line. - - <br><dt><code>-k, --cut</code><dd>Cut from the current cursor position to the end of the current line. - - <br><dt><code>-l, --nofollow</code><dd>When writing files, if the given file is a symbolic link, it is removed +</p> +</dd> +<dt><code>-k, --cut</code></dt> +<dd><p>Make the ’Cut Text’ command (normally ^K) cut from the current cursor +position to the end of the line, instead of cutting the entire line. +</p> +</dd> +<dt><code>-l, --nofollow</code></dt> +<dd><p>When writing files, if the given file is a symbolic link, it is removed and a new file is created. - - <br><dt><code>-m, --mouse</code><dd>Enable mouse support, if available for your system. When enabled, mouse +</p> +</dd> +<dt><code>-m, --mouse</code></dt> +<dd><p>Enable mouse support, if available for your system. When enabled, mouse clicks can be used to place the cursor, set the mark (with a double click), and execute shortcuts. The mouse will work in the X Window -System, and on the console when gpm is running. - - <br><dt><code>-o <dir>, --operatingdir=<dir></code><dd>Set operating directory. Makes <code>nano</code> set up something similar to +System, and on the console when gpm is running. Text can still be +selected through dragging by holding down the Shift key. +</p> +</dd> +<dt><code>-n, --noread</code></dt> +<dd><p>Treat any name given on the command line as a new file. This allows +<code>nano</code> to write to named pipes: it will start with a blank buffer, +and will write to the pipe when the user saves the "file". This way +<code>nano</code> can be used as an editor in combination with for instance +<code>gpg</code> without having to write sensitive data to disk first. +</p> +</dd> +<dt><code>-o <dir>, --operatingdir=<dir></code></dt> +<dd><p>Set operating directory. Makes <code>nano</code> set up something similar to a chroot. - - <br><dt><code>-p, --preserve</code><dd>Preserve the ^Q (XON) and ^S (XOFF) sequences so data being sent to the +</p> +</dd> +<dt><code>-p, --preserve</code></dt> +<dd><p>Preserve the ^Q (XON) and ^S (XOFF) sequences so data being sent to the editor can be can be stopped and started. - - <br><dt><code>-q, --quiet</code><dd>Do not report errors in the nanorc file and ask them to be acknowledged +</p> +</dd> +<dt><code>-q, --quiet</code></dt> +<dd><p>Do not report errors in the nanorc file and ask them to be acknowledged by pressing Enter at startup. - - <br><dt><code>-r <#cols>, --fill=<#cols></code><dd>Wrap lines at column #cols. If this value is 0 or less, wrapping will -occur at the width of the screen less #cols, allowing it to vary along -with the width of the screen if the screen is resized. The default -value is -8. - - <br><dt><code>-s <prog>, --speller=<prog></code><dd>Invoke the given program as the spell checker. By default, <code>nano</code> +</p> +</dd> +<dt><code>-r <number>, --fill=<number></code></dt> +<dd><p>Hard-wrap lines at column <number> (by inserting a newline character). +If the given value is 0 or less, wrapping will occur at the width of +the screen minus the given amount, allowing the wrapping width to +vary along with the width of the screen if and when it is resized. +The default value is -8. This option conflicts with -w – the last +one given takes effect. +</p> +</dd> +<dt><code>-s <program>, --speller=<program></code></dt> +<dd><p>Invoke the given program as the spell checker. By default, <code>nano</code> uses the command specified in the SPELL environment variable, or, if SPELL is not set, its own interactive spell checker that requires the <code>spell</code> program to be installed on your system. - - <br><dt><code>-t, --tempfile</code><dd>Don't ask whether or not to save the current contents of the file when +</p> +</dd> +<dt><code>-t, --tempfile</code></dt> +<dd><p>Don’t ask whether or not to save the current contents of the file when exiting, assume yes. This is most useful when using <code>nano</code> as the composer of a mailer program. - - <br><dt><code>-u, --undo</code><dd>Enable experimental generic-purpose undo code. By default, the undo and -redo shortcuts are Meta-U and Meta-E, respectively. - - <br><dt><code>-v, --view</code><dd>Don't allow the contents of the file to be altered. Note that this +</p> +</dd> +<dt><code>-u, --undo</code></dt> +<dd><p>Enable the experimental generic-purpose undo/redo code. The default undo +and redo shortcuts are Meta-U and Meta-E, respectively. +</p> +</dd> +<dt><code>-v, --view</code></dt> +<dd><p>Don’t allow the contents of the file to be altered. Note that this option should NOT be used in place of correct file permissions to implement a read-only file. - - <br><dt><code>-w, --nowrap</code><dd>Don't wrap long lines at any length. This option overrides any value -for -r. - - <p><a name="Expert-Mode"></a><br><dt><code>-x, --nohelp</code><dd>Expert Mode: don't show the Shortcut Lists at the bottom of the screen. +</p> +</dd> +<dt><code>-w, --nowrap</code></dt> +<dd><p>Don’t hard-wrap long lines at any length. This option conflicts with +-r – the last one given takes effect. +</p> +<a name="Expert-Mode"></a></dd> +<dt><code>-x, --nohelp</code></dt> +<dd><p>Expert Mode: don’t show the Shortcut Lists at the bottom of the screen. This affects the location of the statusbar as well, as in Expert Mode it is located at the very bottom of the editor. - - <p>Note: When accessing the help system, Expert Mode is temporarily -disabled to display the help system navigation keys. - - <br><dt><code>-z, --suspend</code><dd>Enable <code>nano</code>'s suspend ability using the system's suspend +</p> +<p>Note: When accessing the help system, Expert Mode is temporarily +disabled to display the help-system navigation keys. +</p> +</dd> +<dt><code>-z, --suspend</code></dt> +<dd><p>Enable the ability to suspend <code>nano</code> using the system’s suspend keystroke (usually ^Z). - - <br><dt><code>-$, --softwrap</code><dd>Enable 'soft wrapping'. <code>nano</code> will attempt to display the entire -contents of a line, even if it is longer than the screen width. Since -'$' normally refers to a variable in the Unix shell, you should specify -this option last when using other options (e.g. 'nano -wS$') or pass it -separately (e.g. 'nano -wS -$'). - - <br><dt><code>-a, -b, -e, -f, -g, -j</code><dd>Ignored, for compatibility with Pico. +</p> +</dd> +<dt><code>-$, --softwrap</code></dt> +<dd><p>Enable ’soft wrapping’. This will make <code>nano</code> attempt to display the +entire contents of any line, even if it is longer than the screen width, by +continuing it over multiple screen lines. Since +’$’ normally refers to a variable in the Unix shell, you should specify +this option last when using other options (e.g. <code>nano -wS$</code>) or pass it +separately (e.g. <code>nano -wS -$</code>). +</p> +</dd> +<dt><code>-a, -b, -e, -f, -g, -j</code></dt> +<dd><p>Ignored, for compatibility with Pico. +</p></dd> </dl> -<div class="node"> -<a name="Editor-Basics"></a> -<p><hr> -Next: <a rel="next" accesskey="n" href="#Online-Help">Online Help</a>, -Previous: <a rel="previous" accesskey="p" href="#Introduction">Introduction</a>, -Up: <a rel="up" accesskey="u" href="#Top">Top</a> +<hr> +<a name="Editor-Basics"></a> +<div class="header"> +<p> +Next: <a href="#Online-Help" accesskey="n" rel="next">Online Help</a>, Previous: <a href="#Introduction" accesskey="p" rel="previous">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> </div> - +<a name="Editor-Basics-1"></a> <h2 class="chapter">2 Editor Basics</h2> -<ul class="menu"> -<li><a accesskey="1" href="#Entering-Text">Entering Text</a> -<li><a accesskey="2" href="#Special-Functions">Special Functions</a> -<li><a accesskey="3" href="#The-Titlebar">The Titlebar</a> -<li><a accesskey="4" href="#The-Statusbar">The Statusbar</a> -<li><a accesskey="5" href="#Shortcut-Lists">Shortcut Lists</a> -<li><a accesskey="6" href="#Using-the-Mouse">Using the Mouse</a> -</ul> - -<div class="node"> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Entering-Text" accesskey="1">Entering Text</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#Special-Functions" accesskey="2">Special Functions</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#The-Cutbuffer" accesskey="3">The Cutbuffer</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#The-Mark" accesskey="4">The Mark</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#The-Titlebar" accesskey="5">The Titlebar</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#The-Statusbar" accesskey="6">The Statusbar</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#Shortcut-Lists" accesskey="7">Shortcut Lists</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#Using-the-Mouse" accesskey="8">Using the Mouse</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +</table> + +<hr> <a name="Entering-Text"></a> -<p><hr> -Next: <a rel="next" accesskey="n" href="#Special-Functions">Special Functions</a>, -Previous: <a rel="previous" accesskey="p" href="#Editor-Basics">Editor Basics</a>, -Up: <a rel="up" accesskey="u" href="#Editor-Basics">Editor Basics</a> - +<div class="header"> +<p> +Next: <a href="#Special-Functions" accesskey="n" rel="next">Special Functions</a>, Up: <a href="#Editor-Basics" accesskey="u" rel="up">Editor Basics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> </div> - +<a name="Entering-Text-1"></a> <h3 class="section">2.1 Entering Text</h3> -<p>All key sequences in <code>nano</code> are entered using the keyboard. -<code>nano</code> is a "modeless" editor. All keys, with the exception of -Control and Meta key sequences, will enter text into the file being -edited. - -<div class="node"> +<p><code>nano</code> is a "modeless" editor. All keystrokes, with the exception +of Control and Meta key sequences, enter text into the file being edited. +All key sequences in <code>nano</code> are entered using the keyboard. +</p> +<hr> <a name="Special-Functions"></a> -<p><hr> -Next: <a rel="next" accesskey="n" href="#The-Titlebar">The Titlebar</a>, -Previous: <a rel="previous" accesskey="p" href="#Entering-Text">Entering Text</a>, -Up: <a rel="up" accesskey="u" href="#Editor-Basics">Editor Basics</a> - +<div class="header"> +<p> +Next: <a href="#The-Cutbuffer" accesskey="n" rel="next">The Cutbuffer</a>, Previous: <a href="#Entering-Text" accesskey="p" rel="previous">Entering Text</a>, Up: <a href="#Editor-Basics" accesskey="u" rel="up">Editor Basics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> </div> - +<a name="Special-Functions-1"></a> <h3 class="section">2.2 Special Functions</h3> -<p>Special functions use the Control (Ctrl) key, displayed in the help and -shortcut lists as ^; the Meta key, displayed as M; or the Escape (Esc) -key. - - <ul> -<li>Control key sequences are entered by holding down the Ctrl key and -pressing the desired key, or by pressing the Esc key twice and pressing -the desired key. -<li>Pressing Esc twice and then typing a three-digit number from 000 to 255 -will enter the character with the corresponding value. -<li>Meta key sequences are entered by holding down the Meta key (normally +<p>Special functions use the Control key (Ctrl), displayed in the help and +shortcut lists as ^; the Meta key (Alt or Cmd), displayed as M-; or the +Escape key (Esc). +</p> +<ul> +<li> Control key sequences are entered by holding down the Ctrl key and +pressing the desired key, or by pressing the Esc key twice and then +pressing the desired key. +</li><li> Pressing the Esc key twice and then typing a three-digit number from +000 to 255 will enter the character with the corresponding value. +</li><li> Meta key sequences are entered by holding down the Meta key (normally the Alt key) and pressing the desired key, or by pressing the Esc key -once and pressing the desired key. Certain operating systems "swallow" +once and then pressing the desired key. Certain operating systems "swallow" the Alt key so that it never reaches the application; if your operating system does this, you should use the Esc key to generate Meta key -sequences. -</ul> +sequences. +</li></ul> -<div class="node"> +<hr> +<a name="The-Cutbuffer"></a> +<div class="header"> +<p> +Next: <a href="#The-Mark" accesskey="n" rel="next">The Mark</a>, Previous: <a href="#Special-Functions" accesskey="p" rel="previous">Special Functions</a>, Up: <a href="#Editor-Basics" accesskey="u" rel="up">Editor Basics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<a name="The-Cutbuffer-1"></a> +<h3 class="section">2.3 The Cutbuffer</h3> + +<p>Text can be cut from a file, a whole line at a time, by using the ’Cut Text’ +command (default key binding: ^K). The cut line is stored in the cutbuffer. +Consecutive strokes of ^K will add each cut line to this buffer, but a ^K +after any other keystroke will overwrite the entire cutbuffer. +</p> +<p>The contents of the cutbuffer can be pasted back into the file with the +’Uncut Text’ command (default key binding: ^U). +</p> +<p>A line of text can be copied into the cutbuffer (without cutting it) with +the ’Copy Text’ command (default key binding: M-6). +</p> +<hr> +<a name="The-Mark"></a> +<div class="header"> +<p> +Next: <a href="#The-Titlebar" accesskey="n" rel="next">The Titlebar</a>, Previous: <a href="#The-Cutbuffer" accesskey="p" rel="previous">The Cutbuffer</a>, Up: <a href="#Editor-Basics" accesskey="u" rel="up">Editor Basics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<a name="The-Mark-1"></a> +<h3 class="section">2.4 The Mark</h3> + +<p>Text can be selected by first ’setting the Mark’ (default key bindings: +^6 and M-A) and then moving the cursor to the other end of the portion +to be selected. The selected portion of text will be highlighted in +reverse video (or in bold if you set the boldtext option). +This selection can now be cut or copied in its entirety with a single +^K or M-6. Or the selection can be used to limit the scope of a +search-and-replace (^\) or spell-checking session (^T). +</p> +<p>Cutting or copying selected text will toggle the mark off automatically. +If necessary, it can be toggled off manually with another ^6 or M-A. +</p> +<hr> <a name="The-Titlebar"></a> -<p><hr> -Next: <a rel="next" accesskey="n" href="#The-Statusbar">The Statusbar</a>, -Previous: <a rel="previous" accesskey="p" href="#Special-Functions">Special Functions</a>, -Up: <a rel="up" accesskey="u" href="#Editor-Basics">Editor Basics</a> - +<div class="header"> +<p> +Next: <a href="#The-Statusbar" accesskey="n" rel="next">The Statusbar</a>, Previous: <a href="#The-Mark" accesskey="p" rel="previous">The Mark</a>, Up: <a href="#Editor-Basics" accesskey="u" rel="up">Editor Basics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> </div> - -<h3 class="section">2.3 The Titlebar</h3> +<a name="The-Titlebar-1"></a> +<h3 class="section">2.5 The Titlebar</h3> <p>The titlebar is the line displayed at the top of the editor. There are three sections: left, center and right. The section on the left displays the version of <code>nano</code> being used. The center section -displays the current filename, or "New Buffer" if the file has not yet -been named. The section on the right will display "Modified" if the +displays the current filename, or "New Buffer" if the file has not yet +been named. The section on the right will display "Modified" if the file has been modified since it was last saved or opened. - - <p>Special modes: When <code>nano</code> is in "File browser" mode, the center +</p> +<p>Special modes: When <code>nano</code> is in "File browser" mode, the center section will display the current directory instead of the filename. See See <a href="#The-File-Browser">The File Browser</a>, for more info. - -<div class="node"> +</p> +<hr> <a name="The-Statusbar"></a> -<p><hr> -Next: <a rel="next" accesskey="n" href="#Shortcut-Lists">Shortcut Lists</a>, -Previous: <a rel="previous" accesskey="p" href="#The-Titlebar">The Titlebar</a>, -Up: <a rel="up" accesskey="u" href="#Editor-Basics">Editor Basics</a> - +<div class="header"> +<p> +Next: <a href="#Shortcut-Lists" accesskey="n" rel="next">Shortcut Lists</a>, Previous: <a href="#The-Titlebar" accesskey="p" rel="previous">The Titlebar</a>, Up: <a href="#Editor-Basics" accesskey="u" rel="up">Editor Basics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> </div> - -<h3 class="section">2.4 The Statusbar</h3> +<a name="The-Statusbar-1"></a> +<h3 class="section">2.6 The Statusbar</h3> <p>The statusbar is the third line from the bottom of the screen, or the bottom line in Expert Mode. See See <a href="#Expert-Mode">Expert Mode</a>, for more info. It @@ -365,358 +544,1018 @@ shows important and informational messages. Any error messages that occur from using the editor will appear on the statusbar. Any questions that are asked of the user will be asked on the statusbar, and any user input (search strings, filenames, etc.) will be input on the statusbar. - -<div class="node"> +</p> +<hr> <a name="Shortcut-Lists"></a> -<p><hr> -Next: <a rel="next" accesskey="n" href="#Using-the-Mouse">Using the Mouse</a>, -Previous: <a rel="previous" accesskey="p" href="#The-Statusbar">The Statusbar</a>, -Up: <a rel="up" accesskey="u" href="#Editor-Basics">Editor Basics</a> - +<div class="header"> +<p> +Next: <a href="#Using-the-Mouse" accesskey="n" rel="next">Using the Mouse</a>, Previous: <a href="#The-Statusbar" accesskey="p" rel="previous">The Statusbar</a>, Up: <a href="#Editor-Basics" accesskey="u" rel="up">Editor Basics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> </div> - -<h3 class="section">2.5 Shortcut Lists</h3> +<a name="Shortcut-Lists-1"></a> +<h3 class="section">2.7 Shortcut Lists</h3> <p>The Shortcut Lists are the two lines at the bottom of the screen which show some of the more commonly used functions in the editor. - -<div class="node"> +</p> +<hr> <a name="Using-the-Mouse"></a> -<p><hr> -Previous: <a rel="previous" accesskey="p" href="#Shortcut-Lists">Shortcut Lists</a>, -Up: <a rel="up" accesskey="u" href="#Editor-Basics">Editor Basics</a> - +<div class="header"> +<p> +Previous: <a href="#Shortcut-Lists" accesskey="p" rel="previous">Shortcut Lists</a>, Up: <a href="#Editor-Basics" accesskey="u" rel="up">Editor Basics</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> </div> - -<h3 class="section">2.6 Using the Mouse</h3> +<a name="Using-the-Mouse-1"></a> +<h3 class="section">2.8 Using the Mouse</h3> <p>When mouse support has been configured and enabled, a single mouse click places the cursor at the indicated position. Clicking a second time in the same position toggles the mark. Clicking in the shortcut list -executes the selected shortcut. - - <p>The mouse will work in the X Window System, and on the console when gpm +executes the selected shortcut. To be able to select text with the +left button, or paste text with the middle button, hold down the +Shift key during those actions. +</p> +<p>The mouse will work in the X Window System, and on the console when gpm is running. +</p> -<div class="node"> +<hr> <a name="Online-Help"></a> -<p><hr> -Next: <a rel="next" accesskey="n" href="#Feature-Toggles">Feature Toggles</a>, -Previous: <a rel="previous" accesskey="p" href="#Editor-Basics">Editor Basics</a>, -Up: <a rel="up" accesskey="u" href="#Top">Top</a> - +<div class="header"> +<p> +Next: <a href="#Feature-Toggles" accesskey="n" rel="next">Feature Toggles</a>, Previous: <a href="#Editor-Basics" accesskey="p" rel="previous">Editor Basics</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> </div> - +<a name="Online-Help-1"></a> <h2 class="chapter">3 Online Help</h2> -<p>The online help system in <code>nano</code> is available by pressing ^G. -It is fairly self explanatory, documenting the various parts of the +<p>The online help system in <code>nano</code> is available by pressing ^G. +It is fairly self-explanatory, documenting the various parts of the editor and available keystrokes. Navigation is via the ^Y (Page Up) and ^V (Page Down) keys. ^X exits the help system. +</p> -<div class="node"> +<hr> <a name="Feature-Toggles"></a> -<p><hr> -Next: <a rel="next" accesskey="n" href="#Nanorc-Files">Nanorc Files</a>, -Previous: <a rel="previous" accesskey="p" href="#Online-Help">Online Help</a>, -Up: <a rel="up" accesskey="u" href="#Top">Top</a> - +<div class="header"> +<p> +Next: <a href="#Nanorc-Files" accesskey="n" rel="next">Nanorc Files</a>, Previous: <a href="#Online-Help" accesskey="p" rel="previous">Online Help</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> </div> - +<a name="Feature-Toggles-1"></a> <h2 class="chapter">4 Feature Toggles</h2> <p>Toggles allow you to change certain aspects of the editor that would -normally be done via command line options. They are invoked via Meta +normally be done via command-line options. They are invoked via Meta key sequences. See See <a href="#Special-Functions">Special Functions</a>, for more info. The following global toggles are available: +</p> +<dl compact="compact"> +<dt><code>Backup Files Toggle (Meta-B)</code></dt> +<dd><p>toggles the -B (<code>--backup</code>) command line option. +</p> +</dd> +<dt><code>Constant Cursor Position Display Toggle (Meta-C)</code></dt> +<dd><p>toggles the -c (<code>--const</code>) command line option. +</p> +</dd> +<dt><code>Multiple File Buffers Toggle (Meta-F)</code></dt> +<dd><p>toggles the -F (<code>--multibuffer</code>) command line option. +</p> +</dd> +<dt><code>Smart Home Key Toggle (Meta-H)</code></dt> +<dd><p>toggles the -A (<code>--smarthome</code>) command line option. +</p> +</dd> +<dt><code>Auto Indent Toggle (Meta-I)</code></dt> +<dd><p>toggles the -i (<code>--autoindent</code>) command line option. +</p> +</dd> +<dt><code>Cut To End Toggle (Meta-K)</code></dt> +<dd><p>toggles the -k (<code>--cut</code>) command line option. +</p> +</dd> +<dt><code>Long Line Wrapping Toggle (Meta-L)</code></dt> +<dd><p>toggles the -w (<code>--nowrap</code>) command line option. +</p> +</dd> +<dt><code>Mouse Support Toggle (Meta-M)</code></dt> +<dd><p>toggles the -m (<code>--mouse</code>) command line option. +</p> +</dd> +<dt><code>No Conversion From DOS/Mac Format Toggle (Meta-N)</code></dt> +<dd><p>toggles the -N (<code>--noconvert</code>) command line option. +</p> +</dd> +<dt><code>More Space For Editing Toggle (Meta-O)</code></dt> +<dd><p>toggles the -O (<code>--morespace</code>) command line option. +</p> +</dd> +<dt><code>Whitespace Display Toggle (Meta-P)</code></dt> +<dd><p>toggles whitespace display mode if you have a "whitespace" option in +your nanorc. See See <a href="#Whitespace">Whitespace</a>, for more info. +</p> +</dd> +<dt><code>Tabs to Spaces Toggle (Meta-Q)</code></dt> +<dd><p>toggles the -E (<code>--tabstospaces</code>) command line option. +</p> +</dd> +<dt><code>Smooth Scrolling Toggle (Meta-S)</code></dt> +<dd><p>toggles the -S (<code>--smooth</code>) command line option. +</p> +</dd> +<dt><code>Expert/No Help Toggle (Meta-X)</code></dt> +<dd><p>toggles the -x (<code>--nohelp</code>) command line option. +</p> +</dd> +<dt><code>Color Syntax Highlighting Toggle (Meta-Y)</code></dt> +<dd><p>toggles color syntax highlighting if you have color syntaxes in your +nanorc. See See <a href="#Syntax-Highlighting">Syntax Highlighting</a>, for more info. +</p> +</dd> +<dt><code>Suspend Toggle (Meta-Z)</code></dt> +<dd><p>toggles the -z (<code>--suspend</code>) command line option. +</p> +</dd> +<dt><code>Soft Wrapping Toggle (Meta-$)</code></dt> +<dd><p>toggles the -$ (<code>--softwrap</code>) command line option. +</p> +</dd> +</dl> - <dl> -<dt><code>Backup Files Toggle (Meta-B)</code><dd>toggles the -B (<code>--backup</code>) command line option. - - <br><dt><code>Constant Cursor Position Display Toggle (Meta-C)</code><dd>toggles the -c (<code>--const</code>) command line option. - - <br><dt><code>Multiple File Buffers Toggle (Meta-F)</code><dd>toggles the -F (<code>--multibuffer</code>) command line option. - - <br><dt><code>Smart Home Key Toggle (Meta-H)</code><dd>toggles the -A (<code>--smarthome</code>) command line option. - - <br><dt><code>Auto Indent Toggle (Meta-I)</code><dd>toggles the -i (<code>--autoindent</code>) command line option. - - <br><dt><code>Cut To End Toggle (Meta-K)</code><dd>toggles the -k (<code>--cut</code>) command line option. - - <br><dt><code>Long Line Wrapping Toggle (Meta-L)</code><dd>toggles the -w (<code>--nowrap</code>) command line option. - - <br><dt><code>Mouse Support Toggle (Meta-M)</code><dd>toggles the -m (<code>--mouse</code>) command line option. - - <br><dt><code>No Conversion From DOS/Mac Format Toggle (Meta-N)</code><dd>toggles the -N (<code>--noconvert</code>) command line option. - - <br><dt><code>More Space For Editing Toggle (Meta-O)</code><dd>toggles the -O (<code>--morespace</code>) command line option. - - <br><dt><code>Whitespace Display Toggle (Meta-P)</code><dd>toggles whitespace display mode if you have a "whitespace" option in -your nanorc. See See <a href="#Nanorc-Files">Nanorc Files</a>, for more info. - - <br><dt><code>Tabs to Spaces Toggle (Meta-Q)</code><dd>toggles the -E (<code>--tabstospaces</code>) command line option. - - <br><dt><code>Smooth Scrolling Toggle (Meta-S)</code><dd>toggles the -S (<code>--smooth</code>) command line option. - - <br><dt><code>Expert/No Help Toggle (Meta-X)</code><dd>toggles the -x (<code>--nohelp</code>) command line option. - - <br><dt><code>Color Syntax Highlighting Toggle (Meta-Y)</code><dd>toggles color syntax highlighting if you have color syntaxes in your -nanorc. See See <a href="#Nanorc-Files">Nanorc Files</a>, for more info. - - <br><dt><code>Suspend Toggle (Meta-Z)</code><dd>toggles the -z (<code>--suspend</code>) command line option. - - <br><dt><code>Soft Wrapping Toggle (Meta-$)</code><dd>toggles the -$ (<code>--softwrap</code>) command line option. - - </dl> -<div class="node"> +<hr> <a name="Nanorc-Files"></a> -<p><hr> -Next: <a rel="next" accesskey="n" href="#The-File-Browser">The File Browser</a>, -Previous: <a rel="previous" accesskey="p" href="#Feature-Toggles">Feature Toggles</a>, -Up: <a rel="up" accesskey="u" href="#Top">Top</a> - +<div class="header"> +<p> +Next: <a href="#The-File-Browser" accesskey="n" rel="next">The File Browser</a>, Previous: <a href="#Feature-Toggles" accesskey="p" rel="previous">Feature Toggles</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> </div> - +<a name="Nanorc-Files-1"></a> <h2 class="chapter">5 Nanorc Files</h2> <p>The nanorc files contain the default settings for <code>nano</code>. They -should not be in DOS or Mac format. During startup, <code>nano</code> will -first read its system-wide settings from SYSCONFDIR/nanorc, and then -user-specific settings from ~/.nanorc. - - <p>A nanorc file accepts a series of "set" and "unset" commands, which can -be used to configure <code>nano</code> on startup without using the command -line options. Additionally, the "syntax", "color", and "icolor" -keywords are used to define syntax highlighting rules for different text -patterns. <code>nano</code> will read one command per line. - - <p>Options in nanorc files take precedence over <code>nano</code>'s defaults, and -command line options override nanorc settings. Options are also unset +should be in Unix format, not in DOS or Mac format. During startup, +<code>nano</code> will first read the system-wide settings, from /etc/nanorc, +and then the user-specific settings, from ~/.nanorc. +</p> +<p>A nanorc file accepts a series of "set" and "unset" commands, which can +be used to configure <code>nano</code> on startup without using command-line +options. Additionally, there are some commands to define syntax highlighting +and to rebind keys – See <a href="#Syntax-Highlighting">Syntax Highlighting</a>, and See <a href="#Rebinding-Keys">Rebinding Keys</a>. +<code>nano</code> will read one command per line. +</p> +<p>Options in nanorc files take precedence over <code>nano</code>’s defaults, and +command-line options override nanorc settings. Options are also unset by default, except for those that take arguments. - - <p>Quotes inside string parameters don't have to be escaped with +</p> +<p>Quotes inside string parameters don’t have to be escaped with backslashes. The last double quote in the string will be treated as its -end. For example, for the "brackets" option, - - <blockquote> -<code>""')>]}"</code> -</blockquote> - - <p>will match <code>"</code>, <code>'</code>, <code>)</code>, <code>></code>, <code>]</code>, and -<code>}</code>. - - <p>The supported commands and arguments are: - - <dl> -<dt><code>set/unset autoindent</code><dd>Use auto-indentation. - - <br><dt><code>set/unset backup</code><dd>Create backup files in "filename~". - - <br><dt><code>set backupdir "directory"</code><dd>Set the directory where <code>nano</code> puts unique backup files if file +end. For example, for the "brackets" option, <code>""')>]}"</code> will match +<code>"</code>, <code>'</code>, <code>)</code>, <code>></code>, <code>]</code>, and <code>}</code>. +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Settings" accesskey="1">Settings</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#Syntax-Highlighting" accesskey="2">Syntax Highlighting</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#Rebinding-Keys" accesskey="3">Rebinding Keys</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +</table> + +<hr> +<a name="Settings"></a> +<div class="header"> +<p> +Next: <a href="#Syntax-Highlighting" accesskey="n" rel="next">Syntax Highlighting</a>, Up: <a href="#Nanorc-Files" accesskey="u" rel="up">Nanorc Files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<a name="Settings-1"></a> +<h3 class="section">5.1 Settings</h3> + +<p>The supported settings in a nanorc file are: +</p> +<dl compact="compact"> +<dt><code>set/unset allow_insecure_backup</code></dt> +<dd><p>When backing up files, allow the backup to succeed even if its +permissions can’t be (re)set due to special OS considerations. +You should NOT enable this option unless you are sure you need it. +</p> +</dd> +<dt><code>set/unset autoindent</code></dt> +<dd><p>Use auto-indentation. +</p> +</dd> +<dt><code>set/unset backup</code></dt> +<dd><p>When saving a file, back up the previous version of it to the current +filename suffixed with a tilde (<code>~</code>). +</p> +</dd> +<dt><code>set backupdir "directory"</code></dt> +<dd><p>Set the directory where <code>nano</code> puts unique backup files, if file backups are enabled. - - <br><dt><code>set/unset backwards</code><dd>Do backwards searches by default. - - <br><dt><code>set/unset boldtext</code><dd>Use bold text instead of reverse video text. - - <br><dt><code>set brackets "string"</code><dd>Set the characters treated as closing brackets when justifying -paragraphs. They cannot contain blank characters. Only closing -punctuation, optionally followed by closing brackets, can end sentences. -The default value is - - <blockquote> -<code>""')>]}"</code> -</blockquote> - - <br><dt><code>set/unset casesensitive</code><dd>Do case sensitive searches by default. - - <br><dt><code>set/unset const</code><dd>Constantly display the cursor position in the status bar. - - <br><dt><code>set/unset cut</code><dd>Use cut to end of line by default, instead of cutting the whole line. - - <br><dt><code>set fill "n"</code><dd>Wrap lines at column number "n". If "n" is 0 or less, the maximum line -length will be the screen width less "n" columns. The default value is +</p> +</dd> +<dt><code>set/unset backwards</code></dt> +<dd><p>Do backwards searches by default. +</p> +</dd> +<dt><code>set/unset boldtext</code></dt> +<dd><p>Use bold instead of reverse video for the titlebar, statusbar, key combos, +and selected text. This can be overridden for the first three by setting +the options "titlecolor", "statuscolor", and "keycolor". +</p> +</dd> +<dt><code>set brackets "string"</code></dt> +<dd><p>Set the characters treated as closing brackets when justifying +paragraphs. This may not include blank characters. Only closing +punctuation (see "punct"), optionally followed by the specified +closing brackets, can end sentences. The default value is +</p> +<blockquote> +<p><code>""')>]}"</code> +</p></blockquote> + +</dd> +<dt><code>set/unset casesensitive</code></dt> +<dd><p>Do case-sensitive searches by default. +</p> +</dd> +<dt><code>set/unset const</code></dt> +<dd><p>Constantly display the cursor position in the status bar. +</p> +</dd> +<dt><code>set/unset cut</code></dt> +<dd><p>Use cut-to-end-of-line by default, instead of cutting the whole line. +</p> +</dd> +<dt><code>set fill "n"</code></dt> +<dd><p>Hard-wrap lines at column number "n". If "n" is 0 or less, the maximum line +length will be the screen width less "n" columns. The default value is -8. - - <br><dt><code>set/unset historylog</code><dd>Enable ~/.nano_history for saving and reading search/replace strings. - - <br><dt><code>set matchbrackets "string"</code><dd>Set the opening and closing brackets that can be found by bracket -searches. They cannot contain blank characters. The former set must -come before the latter set, and both must be in the same order. The -default value is - - <blockquote> -<code>"(<[{)>]}"</code> -</blockquote> - - <br><dt><code>set/unset morespace</code><dd>Use the blank line below the titlebar as extra editing space. - - <br><dt><code>set/unset mouse</code><dd>Enable mouse support, so that mouse clicks can be used to place the +</p> +</dd> +<dt><code>set functioncolor fgcolor,bgcolor</code></dt> +<dd><p>Specify the color combination to use for the function descriptions +in the two help lines at the bottom of the screen. +See "set titlecolor" for more details. +</p> +</dd> +<dt><code>set/unset historylog</code></dt> +<dd><p>Enable ~/.nano_history for saving and reading search/replace strings. +</p> +</dd> +<dt><code>set keycolor fgcolor,bgcolor</code></dt> +<dd><p>Specify the color combination to use for the shortcut key combos +in the two help lines at the bottom of the screen. +See "set titlecolor" for more details. +</p> +</dd> +<dt><code>set/unset locking</code></dt> +<dd><p>Enable vim-style lock-files for when editing files. +</p> +</dd> +<dt><code>set matchbrackets "string"</code></dt> +<dd><p>Set the opening and closing brackets that can be found by bracket +searches. This may not include blank characters. The opening set must +come before the closing set, and the two sets must be in the same order. +The default value is +</p> +<blockquote> +<p><code>"(<[{)>]}"</code> +</p></blockquote> + +</dd> +<dt><code>set/unset morespace</code></dt> +<dd><p>Use the blank line below the titlebar as extra editing space. +</p> +</dd> +<dt><code>set/unset mouse</code></dt> +<dd><p>Enable mouse support, so that mouse clicks can be used to place the cursor, set the mark (with a double click), or execute shortcuts. - - <br><dt><code>set/unset multibuffer</code><dd>Allow inserting files into their own buffers. - - <br><dt><code>set/unset noconvert</code><dd>Don't convert files from DOS/Mac format. - - <br><dt><code>set/unset nofollow</code><dd>Don't follow symlinks when writing files. - - <br><dt><code>set/unset nohelp</code><dd>Don't display the help lists at the bottom of the screen. - - <br><dt><code>set/unset nonewlines</code><dd>Don't add newlines to the ends of files. - - <br><dt><code>set/unset nowrap</code><dd>Don't wrap text at all. - - <br><dt><code>set operatingdir "directory"</code><dd><code>nano</code> will only read and write files inside "directory" and its +</p> +</dd> +<dt><code>set/unset multibuffer</code></dt> +<dd><p>Allow inserting files into their own buffers. +</p> +</dd> +<dt><code>set/unset noconvert</code></dt> +<dd><p>Don’t convert files from DOS/Mac format. +</p> +</dd> +<dt><code>set/unset nofollow</code></dt> +<dd><p>Don’t follow symlinks when writing files. +</p> +</dd> +<dt><code>set/unset nohelp</code></dt> +<dd><p>Don’t display the help lists at the bottom of the screen. +</p> +</dd> +<dt><code>set/unset nonewlines</code></dt> +<dd><p>Don’t add newlines to the ends of files. +</p> +</dd> +<dt><code>set/unset nowrap</code></dt> +<dd><p>Don’t hard-wrap text at all. +</p> +</dd> +<dt><code>set operatingdir "directory"</code></dt> +<dd><p><code>nano</code> will only read and write files inside "directory" and its subdirectories. Also, the current directory is changed to here, so files are inserted from this directory. By default, the operating directory feature is turned off. - - <br><dt><code>set/unset preserve</code><dd>Preserve the XON and XOFF keys (^Q and ^S). - - <br><dt><code>set punct "string"</code><dd>Set the characters treated as closing punctuation when justifying -paragraphs. They cannot contain blank characters. Only closing -punctuation, optionally followed by closing brackets, can end sentences. -The default value is <code>"!.?"</code>. - - <br><dt><code>set/unset quickblank</code><dd>Do quick statusbar blanking. Statusbar messages will disappear after 1 +</p> +</dd> +<dt><code>set/unset poslog</code></dt> +<dd><p>Save the cursor position of files between editing sessions. +</p> +</dd> +<dt><code>set/unset preserve</code></dt> +<dd><p>Preserve the XON and XOFF keys (^Q and ^S). +</p> +</dd> +<dt><code>set punct "string"</code></dt> +<dd><p>Set the characters treated as closing punctuation when justifying +paragraphs. This may not include blank characters. Only the +specified closing punctuation, optionally followed by closing brackets +(see "brackets"), can end sentences. The default value is <code>"!.?"</code>. +</p> +</dd> +<dt><code>set/unset quickblank</code></dt> +<dd><p>Do quick statusbar blanking. Statusbar messages will disappear after 1 keystroke instead of 25. - - <br><dt><code>set quotestr "string"</code><dd>The email-quote string, used to justify email-quoted paragraphs. This +</p> +</dd> +<dt><code>set/unset quiet</code></dt> +<dd><p>When set, <code>nano</code> will not report errors in the nanorc file nor ask them +to be acknowledged by pressing Enter at startup. If this option is used, it +should be placed at the top of the file to be fully effective. +</p> +</dd> +<dt><code>set quotestr "string"</code></dt> +<dd><p>The email-quote string, used to justify email-quoted paragraphs. This is an extended regular expression if your system supports them, otherwise a literal string. The default value is - - <blockquote> -<code>"^([ \\t]*[#:>\\|}])+"</code> -</blockquote> - - <p>if you have extended regular expression support, or "> " otherwise. -Note that '\\t' stands for a literal Tab character. - - <br><dt><code>set/unset rebinddelete</code><dd>Interpret the Delete key differently so that both Backspace and Delete +</p> +<blockquote> +<p><code>"^([ \\t]*[#:>\\|}])+"</code> +</p></blockquote> + +<p>if you have extended regular expression support, and "> " otherwise. +Note that ’\\t’ stands for a literal Tab character. +</p> +</dd> +<dt><code>set/unset rebinddelete</code></dt> +<dd><p>Interpret the Delete key differently so that both Backspace and Delete work properly. You should only need to use this option if Backspace acts like Delete on your system. - - <br><dt><code>set/unset rebindkeypad</code><dd>Interpret the numeric keypad keys so that they all work properly. You -should only need to use this option if they don't, as mouse support -won't work properly with this option enabled. - - <br><dt><code>set/unset regexp</code><dd>Do extended regular expression searches by default. - - <br><dt><code>set/unset smarthome</code><dd>Make the Home key smarter. When Home is pressed anywhere but at the +</p> +</dd> +<dt><code>set/unset rebindkeypad</code></dt> +<dd><p>Interpret the numeric keypad keys so that they all work properly. You +should only need to use this option if they don’t, as mouse support +won’t work properly with this option enabled. +</p> +</dd> +<dt><code>set/unset regexp</code></dt> +<dd><p>Do extended regular expression searches by default. +</p> +</dd> +<dt><code>set/unset smarthome</code></dt> +<dd><p>Make the Home key smarter. When Home is pressed anywhere but at the very beginning of non-whitespace characters on a line, the cursor will jump to that beginning (either forwards or backwards). If the cursor is already at that position, it will jump to the true beginning of the line. - - <br><dt><code>set/unset smooth</code><dd>Use smooth scrolling by default. - - <br><dt><code>set/unset softwrap</code><dd>Use soft wrapping by default. - - <br><dt><code>set speller "spellprog"</code><dd>Use spelling checker "spellprog" instead of the built-in one, which -calls "spell". - - <br><dt><code>set/unset suspend</code><dd>Allow <code>nano</code> to be suspended. - - <br><dt><code>set/unset suspendenable</code><dd>If <code>nano</code> is allowed to be suspended, allow the suspend key -(usually ^Z) to actually suspend it. - - <br><dt><code>set tabsize "n"</code><dd>Use a tab size of "n" columns. The value of "n" must be greater than 0. +</p> +</dd> +<dt><code>set/unset smooth</code></dt> +<dd><p>Use smooth scrolling by default. +</p> +</dd> +<dt><code>set/unset softwrap</code></dt> +<dd><p>Enable soft line wrapping for easier viewing of very long lines. +</p> +</dd> +<dt><code>set speller "spellprog"</code></dt> +<dd><p>Use spelling checker "spellprog" instead of the built-in one, which +calls "spell". +</p> +</dd> +<dt><code>set statuscolor fgcolor,bgcolor</code></dt> +<dd><p>Specify the color combination to use for the statusbar. +See "set titlecolor" for more details. +</p> +</dd> +<dt><code>set/unset suspend</code></dt> +<dd><p>Allow <code>nano</code> to be suspended. +</p> +</dd> +<dt><code>set tabsize "n"</code></dt> +<dd><p>Use a tab size of "n" columns. The value of "n" must be greater than 0. The default value is 8. - - <br><dt><code>set/unset tabstospaces</code><dd>Convert typed tabs to spaces. - - <br><dt><code>set/unset tempfile</code><dd>Save automatically on exit, don't prompt. - - <br><dt><code>set/unset undo</code><dd>Enable experimental generic-purpose undo code. - - <br><dt><code>set/unset view</code><dd>Disallow file modification. - - <br><dt><code>set whitespace "string"</code><dd>Set the two characters used to display the first characters of tabs and -spaces. They must be single-column characters. - - <br><dt><code>set/unset wordbounds</code><dd>Detect word boundaries more accurately by treating punctuation +</p> +</dd> +<dt><code>set/unset tabstospaces</code></dt> +<dd><p>Convert typed tabs to spaces. +</p> +</dd> +<dt><code>set/unset tempfile</code></dt> +<dd><p>Save automatically on exit, don’t prompt. +</p> +</dd> +<dt><code>set titlecolor fgcolor,bgcolor</code></dt> +<dd><p>Specify the color combination to use for the titlebar. +Valid color names for foreground and background are: +white, black, red, blue, green, yellow, magenta, and cyan. +And either "fgcolor" or ",bgcolor" may be left out. +</p> +</dd> +<dt><code>set/unset undo</code></dt> +<dd><p>Enable the experimental generic-purpose undo/redo code. +</p> +</dd> +<dt><code>set/unset view</code></dt> +<dd><p>Disallow file modification. +</p> +<a name="Whitespace"></a></dd> +<dt><code>set whitespace "string"</code></dt> +<dd><p>Set the two characters used to indicate the presence of tabs and +spaces. They must be single-column characters. The default pair +for a UTF-8 locale is "»·", and for other locales ">.". +</p> +</dd> +<dt><code>set/unset wordbounds</code></dt> +<dd><p>Detect word boundaries more accurately by treating punctuation characters as part of a word. +</p> +</dd> +</dl> - <br><dt><code>syntax "str" ["fileregex" ... ]</code><dd>Defines a syntax named "str" which can be activated via the -Y/–syntax -command line option, or will be automatically activated if the current -filename matches the extended regular expression "fileregex". All -following "color" and "icolor" statements will apply to "syntax" until a -new syntax is defined. - - <p>The "none" syntax is reserved; specifying it on the command line is the -same as not having a syntax at all. The "default" syntax is special: it -takes no "fileregex", and applies to files that don't match any other -syntax's "fileregex". - - <br><dt><code>color fgcolor,bgcolor "regex" ...</code><dd>For the currently defined syntax, display all expressions matching the -extended regular expression "regex" with foreground color "fgcolor" and -background color "bgcolor", at least one of which must be specified. -Legal colors for foreground and background color are: white, black, red, -blue, green, yellow, magenta, and cyan. You may use the prefix "bright" -to force a stronger color highlight for the foreground. If your -terminal supports transparency, not specifying a "bgcolor" tells "nano" +<hr> +<a name="Syntax-Highlighting"></a> +<div class="header"> +<p> +Next: <a href="#Rebinding-Keys" accesskey="n" rel="next">Rebinding Keys</a>, Previous: <a href="#Settings" accesskey="p" rel="previous">Settings</a>, Up: <a href="#Nanorc-Files" accesskey="u" rel="up">Nanorc Files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<a name="Syntax-Highlighting-1"></a> +<h3 class="section">5.2 Syntax Highlighting</h3> + +<p>Coloring the different syntactic elements of a file can be defined +via the following commands in a nanorc file: +</p> +<dl compact="compact"> +<dt><code>syntax "str" ["fileregex" …]</code></dt> +<dd><p>Defines a syntax named "str" which can be activated via the -Y/–syntax +command-line option, or will be automatically activated if the current +filename matches the extended regular expression "fileregex". All +following "color" and "icolor" statements will apply to this "str" +syntax until a new syntax is defined. +</p> +<p>The "none" syntax is reserved; specifying it on the command line is the +same as not having a syntax at all. The "default" syntax is special: it +takes no "fileregex", and applies to files that don’t match any other +syntax’s "fileregex". +</p> +</dd> +<dt><code>linter program [arg …]</code></dt> +<dd><p>For the currently defined syntax, use the given program to invoke the +linter (this overrides the speller function when defined). +</p> +</dd> +<dt><code>header "regex" …</code></dt> +<dd><p>For the currently defined syntax, add one or more regexes which will +be compared against the very first line of the file to be edited, +to determine whether this syntax should be used for that file. +</p> +</dd> +<dt><code>magic ["regex" …]</code></dt> +<dd><p>For the currently defined syntax, add one or more regexes which will be +compared against the result of querying the magic database about the file +to be edited, to determine whether this syntax should be used for that +file. This functionality only works when libmagic is installed on the +system and will be silently ignored otherwise. +</p> +</dd> +<dt><code>color fgcolor,bgcolor "regex" …</code></dt> +<dd><p>For the currently defined syntax, display all expressions matching the +extended regular expression "regex" with foreground color "fgcolor" and +background color "bgcolor", at least one of which must be specified. +Valid colors for foreground and background are: white, black, red, +blue, green, yellow, magenta, and cyan. You may use the prefix "bright" +to get a stronger color highlight for the foreground. If your +terminal supports transparency, not specifying a "bgcolor" tells <code>nano</code> to attempt to use a transparent background. +</p> +</dd> +<dt><code>icolor fgcolor,bgcolor "regex" …</code></dt> +<dd><p>Same as above, except that the expression matching is case insensitive. +</p> +</dd> +<dt><code>color fgcolor,bgcolor start="sr" end="er"</code></dt> +<dd><p>Display expressions which start with the extended regular expression +"sr" and end with the extended regular expression "er" with foreground +color "fgcolor" and background color "bgcolor", at least one of which +must be specified. This allows syntax highlighting to span multiple +lines. Note that all subsequent instances of "sr" after an initial "sr" +is found will be highlighted until the first instance of "er". +</p> +</dd> +<dt><code>icolor fgcolor,bgcolor start="sr" end="er"</code></dt> +<dd><p>Same as above, except that the expression matching is case insensitive. +</p> +</dd> +<dt><code>include "syntaxfile"</code></dt> +<dd><p>Read in self-contained color syntaxes from "syntaxfile". Note that +"syntaxfile" can only contain the above commands, from "syntax" to +"icolor". +</p> +</dd> +<dt><code>extendsyntax str directive [arg …]</code></dt> +<dd><p>Extend the syntax previously defined as str to include new information. +Allows you to add a new color, icolor, magic, header, or linter directive +to an already defined syntax. Useful when you want to add to definitions +from the system-installed syntax definitions (which are normally not writable). +</p> +</dd> +</dl> - <br><dt><code>icolor fgcolor,bgcolor "regex" ...</code><dd>Same as above, except that the expression matching is case insensitive. +<hr> +<a name="Rebinding-Keys"></a> +<div class="header"> +<p> +Previous: <a href="#Syntax-Highlighting" accesskey="p" rel="previous">Syntax Highlighting</a>, Up: <a href="#Nanorc-Files" accesskey="u" rel="up">Nanorc Files</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> +</div> +<a name="Rebinding-Keys-1"></a> +<h3 class="section">5.3 Rebinding Keys</h3> + +<p>Key bindings may be reassigned via the following two commands in a +nanorc file: +</p> +<dl compact="compact"> +<dt><code>bind key function menu</code></dt> +<dd><p>Rebinds <code>key</code> to <code>function</code> in the context of <code>menu</code> +(or in all menus where the function exists by using <code>all</code>). +</p> +</dd> +<dt><code>unbind key menu</code></dt> +<dd><p>Unbinds <code>key</code> from the specified <code>menu</code> +(or from all menus where it exists by using <code>all</code>). +</p> +</dd> +</dl> - <br><dt><code>color fgcolor,bgcolor start="sr" end="er"</code><dd>Display expressions which start with the extended regular expression -"sr" and end with the extended regular expression "er" with foreground -color "fgcolor" and background color "bgcolor", at least one of which -must be specified. This allows syntax highlighting to span multiple -lines. Note that all subsequent instances of "sr" after an initial "sr" -is found will be highlighted until the first instance of "er". +<p>The format of <code>key</code> should be one of: +</p> +<dl compact="compact"> +<dt><code>^</code></dt> +<dd><p>followed by an alpha character or the word "Space". +Example: <code>^C</code> +</p> +</dd> +<dt><code>M-</code></dt> +<dd><p>followed by a printable character or the word "Space". +Example: <code>M-C</code> +</p> +</dd> +<dt><code>F</code></dt> +<dd><p>followed by a numeric value from 1 to 16. +Example: <code>F10</code> +</p> +</dd> +</dl> - <br><dt><code>icolor fgcolor,bgcolor start="sr" end="er"</code><dd>Same as above, except that the expression matching is case insensitive. +<p>Valid names for the <code>function</code> to be bound are: +</p> +<dl compact="compact"> +<dt><code>help</code></dt> +<dd><p>Invokes the help viewer. +</p> +</dd> +<dt><code>cancel</code></dt> +<dd><p>Cancels the current command. +</p> +</dd> +<dt><code>exit</code></dt> +<dd><p>Exits from the program (or from the help viewer or the file browser). +</p> +</dd> +<dt><code>writeout</code></dt> +<dd><p>Writes the current buffer to disk. +</p> +</dd> +<dt><code>insert</code></dt> +<dd><p>Inserts a file into the current buffer (or into a new buffer when multibuffer +is enabled). +</p> +</dd> +<dt><code>whereis</code></dt> +<dd><p>Searches for text in the current buffer. +</p> +</dd> +<dt><code>searchagain</code></dt> +<dd><p>Repeats the last search command. +</p> +</dd> +<dt><code>replace</code></dt> +<dd><p>Interactively replaces text within the current buffer. +</p> +</dd> +<dt><code>cut</code></dt> +<dd><p>Cuts and stores the current line (or the marked region). +</p> +</dd> +<dt><code>copytext</code></dt> +<dd><p>Copies the current line (or the marked region) without deleting it. +</p> +</dd> +<dt><code>uncut</code></dt> +<dd><p>Copies the currently stored text into the current buffer at the +current cursor position. +</p> +</dd> +<dt><code>mark</code></dt> +<dd><p>Sets the mark at the current position, to start selecting text. +</p> +</dd> +<dt><code>cutrestoffile</code></dt> +<dd><p>Cuts all text from the cursor position till the end of the buffer. +</p> +</dd> +<dt><code>curpos</code></dt> +<dd><p>Shows the current cursor position: the line, column, and character positions. +</p> +</dd> +<dt><code>wordcount</code></dt> +<dd><p>Counts the number of words, lines and characters in the current buffer. +</p> +</dd> +<dt><code>speller</code></dt> +<dd><p>Invokes a spell-checking program (or a linting program, if the current +syntax highlighting defines one). +</p> +</dd> +<dt><code>justify</code></dt> +<dd><p>Justifies the current paragraph. +</p> +</dd> +<dt><code>fulljustify</code></dt> +<dd><p>Justifies the entire current buffer. +</p> +</dd> +<dt><code>indent</code></dt> +<dd><p>Indents (shifts to the right) the currently marked text. +</p> +</dd> +<dt><code>unindent</code></dt> +<dd><p>Unindents (shifts to the left) the currently marked text. +</p> +</dd> +<dt><code>left</code></dt> +<dd><p>Goes left one position (in the editor or browser). +</p> +</dd> +<dt><code>right</code></dt> +<dd><p>Goes right one position (in the editor or browser). +</p> +</dd> +<dt><code>up</code></dt> +<dd><p>Goes one line up (in the editor or browser). +</p> +</dd> +<dt><code>down</code></dt> +<dd><p>Goes one line down (in the editor or browser). +</p> +</dd> +<dt><code>scrollup</code></dt> +<dd><p>Scrolls up one line of text from the current position. +</p> +</dd> +<dt><code>scrolldown</code></dt> +<dd><p>Scrolls down one line of text from the current position. +</p> +</dd> +<dt><code>nextword</code></dt> +<dd><p>Moves the cursor to the beginning of the next word. +</p> +</dd> +<dt><code>prevword</code></dt> +<dd><p>Moves the cursor to the beginning of the previous word. +</p> +</dd> +<dt><code>home</code></dt> +<dd><p>Moves the cursor to the beginning of the current line. +</p> +</dd> +<dt><code>end</code></dt> +<dd><p>Moves the cursor to the end of the current line. +</p> +</dd> +<dt><code>beginpara</code></dt> +<dd><p>Moves the cursor to the beginning of the current paragraph. +</p> +</dd> +<dt><code>endpara</code></dt> +<dd><p>Moves the cursor to the end of the current paragraph. +</p> +</dd> +<dt><code>prevpage</code></dt> +<dd><p>Goes up one screenful. +</p> +</dd> +<dt><code>nextpage</code></dt> +<dd><p>Goes down one screenful. +</p> +</dd> +<dt><code>firstline</code></dt> +<dd><p>Goes to the first line of the file. +</p> +</dd> +<dt><code>lastline</code></dt> +<dd><p>Goes to the last line of the file. +</p> +</dd> +<dt><code>gotoline</code></dt> +<dd><p>Goes to a specific line (and column if specified). +</p> +</dd> +<dt><code>findbracket</code></dt> +<dd><p>Moves the cursor to the bracket (brace, parenthesis, etc.) that matches +(pairs) with the one under the cursor. +</p> +</dd> +<dt><code>prevbuf</code></dt> +<dd><p>Switches to editing/viewing the previous buffer when using multibuffer mode. +</p> +</dd> +<dt><code>nextbuf</code></dt> +<dd><p>Switches to editing/viewing the next buffer when using multibuffer mode. +</p> +</dd> +<dt><code>verbatim</code></dt> +<dd><p>Inserts the next character verbatim into the file. +</p> +</dd> +<dt><code>tab</code></dt> +<dd><p>Inserts a tab at the current cursor location. +</p> +</dd> +<dt><code>enter</code></dt> +<dd><p>Inserts a new line below the current one. +</p> +</dd> +<dt><code>delete</code></dt> +<dd><p>Deletes the character under the cursor. +</p> +</dd> +<dt><code>backspace</code></dt> +<dd><p>Deletes the character before the cursor. +</p> +</dd> +<dt><code>undo</code></dt> +<dd><p>Undoes the last performed text action (add text, delete text, etc). +</p> +</dd> +<dt><code>redo</code></dt> +<dd><p>Redoes the last undone action (i.e., it undoes an undo). +</p> +</dd> +<dt><code>refresh</code></dt> +<dd><p>Refreshes the screen. +</p> +</dd> +<dt><code>suspend</code></dt> +<dd><p>Suspends the editor (if the suspending function is enabled, see the +"suspendenable" entry below). +</p> +</dd> +<dt><code>casesens</code></dt> +<dd><p>Toggles case sensitivity in searching (search/replace menus only). +</p> +</dd> +<dt><code>regexp</code></dt> +<dd><p>Toggles whether searching/replacing is based on literal strings or regular expressions. +</p> +</dd> +<dt><code>backwards</code></dt> +<dd><p>Toggles whether searching/replacing goes forward or backward. +</p> +</dd> +<dt><code>prevhistory</code></dt> +<dd><p>Shows the previous history entry in the prompt menus (e.g. search). +</p> +</dd> +<dt><code>nexthistory</code></dt> +<dd><p>Shows the next history entry in the prompt menus (e.g. search). +</p> +</dd> +<dt><code>dontreplace</code></dt> +<dd><p>Switches back to searching instead of replacing. +</p> +</dd> +<dt><code>gototext</code></dt> +<dd><p>Searches for files matching a string in the file browser (reading or writing files). +</p> +</dd> +<dt><code>dosformat</code></dt> +<dd><p>When writing a file, switches to writing a DOS format (CR/LF). +</p> +</dd> +<dt><code>macformat</code></dt> +<dd><p>When writing a file, switches to writing a Mac format. +</p> +</dd> +<dt><code>append</code></dt> +<dd><p>When writing a file, appends to the end instead of overwriting. +</p> +</dd> +<dt><code>prepend</code></dt> +<dd><p>When writing a file, ’prepends’ (writes at the beginning) instead of overwriting. +</p> +</dd> +<dt><code>backup</code></dt> +<dd><p>When writing a file, creates a backup of the current file. +</p> +</dd> +<dt><code>firstfile</code></dt> +<dd><p>Goes to the first file when using the file browser (reading or writing files). +</p> +</dd> +<dt><code>lastfile</code></dt> +<dd><p>Goes to the last file when using the file browser (reading or writing files). +</p> +</dd> +<dt><code>nohelp</code></dt> +<dd><p>Toggles the presence of the two-line list of key bindings at the bottom of the screen. +</p> +</dd> +<dt><code>constupdate</code></dt> +<dd><p>Toggles the constant display of the current line, column, and character positions. +</p> +</dd> +<dt><code>morespace</code></dt> +<dd><p>Toggles the presence of the blank line which ’separates’ the titlebar from the file text. +</p> +</dd> +<dt><code>smoothscroll</code></dt> +<dd><p>Toggles smooth scrolling (when moving around with the arrow keys). +</p> +</dd> +<dt><code>softwrap</code></dt> +<dd><p>Toggles the displaying of overlong lines on multiple screen lines. +</p> +</dd> +<dt><code>whitespacedisplay</code></dt> +<dd><p>Toggles the showing of whitespace. +</p> +</dd> +<dt><code>nosyntax</code></dt> +<dd><p>Toggles syntax highlighting. +</p> +</dd> +<dt><code>smarthome</code></dt> +<dd><p>Toggles the smartness of the Home key. +</p> +</dd> +<dt><code>autoindent</code></dt> +<dd><p>Toggles whether new lines will contain the same amount of whitespace as the preceding line. +</p> +</dd> +<dt><code>cuttoend</code></dt> +<dd><p>Toggles whether cutting text will cut the whole line or just from the current cursor +position to the end of the line. +</p> +</dd> +<dt><code>nowrap</code></dt> +<dd><p>Toggles whether long lines will be hard-wrapped to the next line. +</p> +</dd> +<dt><code>tabstospaces</code></dt> +<dd><p>Toggles whether typed tabs will be converted to spaces. +</p> +</dd> +<dt><code>backupfile</code></dt> +<dd><p>Toggles whether a backup will be made of the file to be edited. +</p> +</dd> +<dt><code>multibuffer</code></dt> +<dd><p>Toggles the use of multiple file buffers (if available). +</p> +</dd> +<dt><code>mouse</code></dt> +<dd><p>Toggles mouse support. +</p> +</dd> +<dt><code>noconvert</code></dt> +<dd><p>Toggles automatic conversion of files from DOS/Mac format. +</p> +</dd> +<dt><code>suspendenable</code></dt> +<dd><p>Toggles whether the suspend sequence (normally ^Z) will suspend the editor window. +</p> +</dd> +</dl> - <br><dt><code>include "syntaxfile"</code><dd>Read in self-contained color syntaxes from "syntaxfile". Note that -"syntaxfile" can only contain "syntax", "color", and "icolor" commands. +<p>Valid names for <code>menu</code> are: +</p> +<dl compact="compact"> +<dt><code>main</code></dt> +<dd><p>The main editor window where text is entered and edited. +</p> +</dd> +<dt><code>search</code></dt> +<dd><p>The search menu (AKA whereis). +</p> +</dd> +<dt><code>replace</code></dt> +<dd><p>The ’search to replace’ menu. +</p> +</dd> +<dt><code>replacewith</code></dt> +<dd><p>The ’replace with’ menu, which comes up after ’search to replace’. +</p> +</dd> +<dt><code>gotoline</code></dt> +<dd><p>The ’goto line (and column)’ menu. +</p> +</dd> +<dt><code>writeout</code></dt> +<dd><p>The ’write file’ menu. +</p> +</dd> +<dt><code>insert</code></dt> +<dd><p>The ’insert file’ menu. +</p> +</dd> +<dt><code>extcmd</code></dt> +<dd><p>The menu for inserting output from an external command, reached from the insert menu. +</p> +</dd> +<dt><code>help</code></dt> +<dd><p>The help-viewer menu. +</p> +</dd> +<dt><code>spell</code></dt> +<dd><p>The interactive spell checker Yes/no menu. +</p> +</dd> +<dt><code>linter</code></dt> +<dd><p>The linter menu. +</p> +</dd> +<dt><code>browser</code></dt> +<dd><p>The file browser for inserting or writing a file. +</p> +</dd> +<dt><code>whereisfile</code></dt> +<dd><p>The ’search for a file’ menu in the file browser. +</p> +</dd> +<dt><code>gotodir</code></dt> +<dd><p>The ’go to directory’ menu in the file browser. +</p> +</dd> +<dt><code>all</code></dt> +<dd><p>A special name meaning: apply to all menus where this function exists. +</p></dd> +</dl> - </dl> -<div class="node"> +<hr> <a name="The-File-Browser"></a> -<p><hr> -Next: <a rel="next" accesskey="n" href="#Pico-Compatibility">Pico Compatibility</a>, -Previous: <a rel="previous" accesskey="p" href="#Nanorc-Files">Nanorc Files</a>, -Up: <a rel="up" accesskey="u" href="#Top">Top</a> - +<div class="header"> +<p> +Next: <a href="#Pico-Compatibility" accesskey="n" rel="next">Pico Compatibility</a>, Previous: <a href="#Nanorc-Files" accesskey="p" rel="previous">Nanorc Files</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> </div> - +<a name="The-File-Browser-1"></a> <h2 class="chapter">6 The File Browser</h2> -<p>When reading or writing files, pressing ^T will invoke the file browser. +<p>When reading or writing files, pressing ^T will invoke the file browser. Here, one can navigate directories in a graphical manner in order to find the desired file. - - <p>Basic movement in the file browser is accomplished with the arrow keys, +</p> +<p>Basic movement in the file browser is accomplished with the arrow keys, page up, and page down. More advanced movement is accomplished by -searching via ^W (or 'w') and changing directories via ^_ (or 'g'). The -behavior of the Enter (or 's') key varies by what is currently selected. +searching via ^W (or ’w’) and changing directories via ^_ (or ’g’). The +behavior of the Enter (or ’s’) key varies by what is currently selected. If the currently selected object is a directory, the file browser will enter and display the contents of the directory. If the object is a file, this filename and path are copied to the statusbar, and the file browser exits. +</p> -<div class="node"> +<hr> <a name="Pico-Compatibility"></a> -<p><hr> -Next: <a rel="next" accesskey="n" href="#Building-and-Configure-Options">Building and Configure Options</a>, -Previous: <a rel="previous" accesskey="p" href="#The-File-Browser">The File Browser</a>, -Up: <a rel="up" accesskey="u" href="#Top">Top</a> - +<div class="header"> +<p> +Next: <a href="#Building-and-Configure-Options" accesskey="n" rel="next">Building and Configure Options</a>, Previous: <a href="#The-File-Browser" accesskey="p" rel="previous">The File Browser</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> </div> - +<a name="Pico-Compatibility-1"></a> <h2 class="chapter">7 Pico Compatibility</h2> <p><code>nano</code> attempts to emulate Pico as closely as possible, but there are certain differences between the editors: - - <dl> -<dt><code>Search and Replace History</code><dd>As of version 1.1.99pre1 of <code>nano</code>, text entered as search or +</p> +<dl compact="compact"> +<dt><code>Search and Replace History</code></dt> +<dd><p>As of version 1.1.99pre1 of <code>nano</code>, text entered as search or replace strings will be stored and can be accessed with the up/down arrow keys. Previously, <code>nano</code> offered a more consistent, but -incompatible with Pico, method for entering search and replace strings. +incompatible with Pico, method for entering search and replace strings. In the old method, previous entries would be displayed by default as editable text in front of the cursor, as opposed to being bracketed and uneditable as it is in Pico. The old behavior could be made compatible @@ -725,143 +1564,210 @@ with Pico via the <code>-p</code> option, but recent versions of Pico use the editor. Since, with the new method, search and replace strings can still be edited by simply hitting the up arrow key once, the old method was removed completely. +</p> - <br><dt><code>Writing, Appending, or Prepending Selected Text to Files</code><dd>Text selected using the marking key (^^) can be written out, appended, +</dd> +<dt><code>Writing, Appending, or Prepending Selected Text to Files</code></dt> +<dd><p>Text selected using the marking key (^^) can be written out, appended, or prepended to a new or existing file using the WriteOut key (^O). - - <br><dt><code>Toggles</code><dd>Many options which alter the functionality of the program can be -"toggled" on or off using Meta key sequences, meaning the program does +</p> +</dd> +<dt><code>Toggles</code></dt> +<dd><p>Many options which alter the functionality of the program can be +"toggled" on or off using Meta key sequences, meaning the program does not have to be restarted to turn a particular feature of the editor on or off. Please see the internal help function (^G) for a list of what functions can be toggled for a particular version of <code>nano</code>. See See <a href="#Feature-Toggles">Feature Toggles</a>, for more info. - - <br><dt><code>Cursor Position Display</code><dd>The output of the "Display Cursor Position" in <code>nano</code> displays -the given column position, as well as the row and total character -position of the cursor. - - <br><dt><code>Interactive Replace and Spell Checker</code><dd>It is worth noting that <code>nano</code>'s replace function is interactive, -i.e. it does not stop after one search string is found and automatically -replace it. The <code>nano</code> implementation will pause at each search -string found and query whether to replace this instance or not. The +</p> +</dd> +<dt><code>Cursor Position Display</code></dt> +<dd><p>The output of the "Display Cursor Position" in <code>nano</code> displays +the current line position of the cursor, as well as the column and +total character position. +</p> +</dd> +<dt><code>Interactive Replace and Spell Checker</code></dt> +<dd><p>It is worth noting that <code>nano</code>’s replace function is interactive, +i.e. it does not stop after one search string was found and automatically +replaced. The <code>nano</code> implementation will pause at each found +search string and query whether to replace this instance or not. The internal spell checker operates similarly. Note that there is no way to force these functions to behave in the Pico fashion. As of version 1.1.99pre1, misspelled words are sorted and trimmed for uniqueness in -the internal spell checker such that the words 'apple' and 'Apple' will -be prompted for correction separately. +the internal spell checker such that the words ’apple’ and ’Apple’ will +be prompted for correction separately. +</p></dd> </dl> -<div class="node"> -<a name="Building-and-Configure-Options"></a> -<p><hr> -Previous: <a rel="previous" accesskey="p" href="#Pico-Compatibility">Pico Compatibility</a>, -Up: <a rel="up" accesskey="u" href="#Top">Top</a> +<hr> +<a name="Building-and-Configure-Options"></a> +<div class="header"> +<p> +Previous: <a href="#Pico-Compatibility" accesskey="p" rel="previous">Pico Compatibility</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p> </div> - +<a name="Building-and-Configure-Options-1"></a> <h2 class="chapter">8 Building and Configure Options</h2> <p>Building <code>nano</code> from source is fairly straightforward if you are familiar with compiling programs with autoconf support: - - <ul> -<li>tar xvfz nano-x.y.z.tar.gz (where x.y.z is the version of +</p> +<ul> +<li> tar xvfz nano-x.y.z.tar.gz (where x.y.z is the version of <code>nano</code>) -<li>cd nano-x.y.z/ -<li>./configure -<li>make -<li>make install -</ul> - - <p>The possible options to <code>./configure</code> are: - - <dl> -<dt><code>--disable-browser</code><dd>Disable the mini file browser when reading or writing files. +</li><li> cd nano-x.y.z/ +</li><li> ./configure +</li><li> make +</li><li> make install +</li></ul> - <br><dt><code>--disable-help</code><dd>Disable the help function. Doing this makes the binary much smaller, +<p>The possible options to <code>./configure</code> are: +</p> +<dl compact="compact"> +<dt><code>--disable-browser</code></dt> +<dd><p>Disable the mini file browser when reading or writing files. +</p> +</dd> +<dt><code>--disable-color</code></dt> +<dd><p>Disable support for syntax coloring of files using the nanorc file. +</p> +</dd> +<dt><code>--disable-extra</code></dt> +<dd><p>Disable extra features. At the moment, this is just easter-egg-type +stuff. +</p> +</dd> +<dt><code>--disable-help</code></dt> +<dd><p>Disable the help function. Doing this makes the binary much smaller, but makes it difficult for new users to learn more than very basic things about using the editor. - - <br><dt><code>--disable-justify</code><dd>Disable the justify and unjustify functions. - - <br><dt><code>--disable-mouse</code><dd>Disable all mouse functionality. This also disables the -m command line -option, which enables the mouse functionality. - - <br><dt><code>--disable-operatingdir</code><dd>Disable setting the operating directory. This also disables the -o -command line option, which sets the operating directory. - - <br><dt><code>--disable-speller</code><dd>Disable use of the spell checker. This also disables the -s command -line option, which allows specifying an alternate spell checker. - - <br><dt><code>--disable-tabcomp</code><dd>Disable the tab completion code when reading or writing files. - - <br><dt><code>--disable-wrapping</code><dd>Disable all long line wrapping. This also eliminates the -w command -line option, which enables long line wrapping. - - <br><dt><code>--enable-tiny</code><dd>This option disables all the above. It also disables some of the larger -internals of the editor, like the marking code and the cut to end of -line code. It also disables the function toggles. - - <br><dt><code>--enable-debug</code><dd>Enable support for runtime debug output. This can get pretty messy, so -chances are you only want this feature to work on the nano source. - - <br><dt><code>--enable-extra</code><dd>Enable extra features. At the moment, this is just easter egg-type -stuff. - - <br><dt><code>--enable-color</code><dd>Enable support for syntax coloring of files using the nanorc file. This -enables nanorc support as well. - - <br><dt><code>--enable-multibuffer</code><dd>Enable support for opening multiple files at a time and switching +</p> +</dd> +<dt><code>--disable-justify</code></dt> +<dd><p>Disable the justify and unjustify functions. +</p> +</dd> +<dt><code>--disable-libmagic</code></dt> +<dd><p>Disable the use of the library of magic-number tests (for determining +the file type and thus which syntax to use for colouring – often the +tests on filename extension and header line will be enough). +</p> +</dd> +<dt><code>--disable-mouse</code></dt> +<dd><p>Disable all mouse functionality. This also eliminates the -m +command-line option, which enables the mouse functionality. +</p> +</dd> +<dt><code>--disable-multibuffer</code></dt> +<dd><p>Disable support for opening multiple files at a time and switching between them on the fly. - - <br><dt><code>--enable-nanorc</code><dd>Enable support for reading the nanorc file at startup. You can store -custom settings in the nanorc file rather than having to pass command -line options to get desired behavior. See See <a href="#Nanorc-Files">Nanorc Files</a>, for -more info. - - <br><dt><code>--enable-all</code><dd>Shortcut for enabling the above four features (extra, color, -multibuffer, and nanorc). - - <br><dt><code>--disable-nls</code><dd>Disables Native Language support. This will disable use of the +</p> +</dd> +<dt><code>--disable-nanorc</code></dt> +<dd><p>Disable support for reading the nanorc files at startup. With such +support, you can store custom settings in a system-wide and a per-user +nanorc file rather than having to pass command-line options to get +the desired behavior. See See <a href="#Nanorc-Files">Nanorc Files</a>, for more info. +</p> +</dd> +<dt><code>--disable-operatingdir</code></dt> +<dd><p>Disable setting the operating directory. This also eliminates the -o +command-line option, which sets the operating directory. +</p> +</dd> +<dt><code>--disable-speller</code></dt> +<dd><p>Disable use of the spell checker. This also eliminates the -s +command-line option, which allows specifying an alternate spell checker. +</p> +</dd> +<dt><code>--disable-tabcomp</code></dt> +<dd><p>Disable the tab completion code when reading or writing files. +</p> +</dd> +<dt><code>--disable-wrapping</code></dt> +<dd><p>Disable hard-wrapping of overlong lines. This also eliminates the -w +command-line option, which enables long-line wrapping. +</p> +</dd> +<dt><code>--enable-tiny</code></dt> +<dd><p>This option disables all the above. It also disables some of the larger +internals of the editor, like the marking code and the cut-to-end-of-line +code. It also disables the function toggles. +</p> +</dd> +<dt><code>--enable-debug</code></dt> +<dd><p>Enable support for runtime debug output. This can get pretty messy, so +chances are you only want this feature when you’re working on the nano source. +</p> +</dd> +<dt><code>--disable-nls</code></dt> +<dd><p>Disables Native Language support. This will disable use of the available GNU <code>nano</code> translations. - - <br><dt><code>--disable-wrapping-as-root</code><dd>Disable long line wrapping by default when nano is run as root. - - <br><dt><code>--enable-utf8</code><dd>Enable support for reading and writing Unicode files. This will require +</p> +</dd> +<dt><code>--disable-wrapping-as-root</code></dt> +<dd><p>Disable hard-wrapping of overlong lines by default when <code>nano</code> +is run as root. +</p> +</dd> +<dt><code>--enable-utf8</code></dt> +<dd><p>Enable support for reading and writing Unicode files. This will require either a wide version of curses, or a UTF-8-enabled version of Slang. +</p> +</dd> +<dt><code>--disable-utf8</code></dt> +<dd><p>Disable support for reading and writing Unicode files. Normally the +configure script auto-detects whether to enable UTF-8 support or not. +You can use this or the previous option to override that detection. +</p> +</dd> +<dt><code>--with-slang</code></dt> +<dd><p>Compile <code>nano</code> against Slang instead of against ncurses or other +curses libraries. +</p> +</dd> +</dl> - <br><dt><code>--disable-utf8</code><dd>Disable support for reading and writing Unicode files. - - <br><dt><code>--with-slang</code><dd>Compiling <code>nano</code> with Slang is supported, and will make the binary -notably smaller than if compiled with ncurses or other curses libraries. +<a name="SEC_Contents"></a> +<h2 class="contents-heading">Table of Contents</h2> + +<div class="contents"> + +<ul class="no-bullet"> + <li><a name="toc-Introduction-1" href="#Introduction">1 Introduction</a> + <ul class="no-bullet"> + <li><a name="toc-Overview-1" href="#Overview">1.1 Overview</a></li> + <li><a name="toc-Command-Line-Options-1" href="#Command-Line-Options">1.2 Command Line Options</a></li> + </ul></li> + <li><a name="toc-Editor-Basics-1" href="#Editor-Basics">2 Editor Basics</a> + <ul class="no-bullet"> + <li><a name="toc-Entering-Text-1" href="#Entering-Text">2.1 Entering Text</a></li> + <li><a name="toc-Special-Functions-1" href="#Special-Functions">2.2 Special Functions</a></li> + <li><a name="toc-The-Cutbuffer-1" href="#The-Cutbuffer">2.3 The Cutbuffer</a></li> + <li><a name="toc-The-Mark-1" href="#The-Mark">2.4 The Mark</a></li> + <li><a name="toc-The-Titlebar-1" href="#The-Titlebar">2.5 The Titlebar</a></li> + <li><a name="toc-The-Statusbar-1" href="#The-Statusbar">2.6 The Statusbar</a></li> + <li><a name="toc-Shortcut-Lists-1" href="#Shortcut-Lists">2.7 Shortcut Lists</a></li> + <li><a name="toc-Using-the-Mouse-1" href="#Using-the-Mouse">2.8 Using the Mouse</a></li> + </ul></li> + <li><a name="toc-Online-Help-1" href="#Online-Help">3 Online Help</a></li> + <li><a name="toc-Feature-Toggles-1" href="#Feature-Toggles">4 Feature Toggles</a></li> + <li><a name="toc-Nanorc-Files-1" href="#Nanorc-Files">5 Nanorc Files</a> + <ul class="no-bullet"> + <li><a name="toc-Settings-1" href="#Settings">5.1 Settings</a></li> + <li><a name="toc-Syntax-Highlighting-1" href="#Syntax-Highlighting">5.2 Syntax Highlighting</a></li> + <li><a name="toc-Rebinding-Keys-1" href="#Rebinding-Keys">5.3 Rebinding Keys</a></li> + </ul></li> + <li><a name="toc-The-File-Browser-1" href="#The-File-Browser">6 The File Browser</a></li> + <li><a name="toc-Pico-Compatibility-1" href="#Pico-Compatibility">7 Pico Compatibility</a></li> + <li><a name="toc-Building-and-Configure-Options-1" href="#Building-and-Configure-Options">8 Building and Configure Options</a></li> +</ul> +</div> - </dl> +<hr> - <div class="contents"> -<h2>Table of Contents</h2> -<ul> -<li><a name="toc_Introduction" href="#Introduction">1 Introduction</a> -<ul> -<li><a href="#Overview">1.1 Overview</a> -<li><a href="#Command-Line-Options">1.2 Command Line Options</a> -</li></ul> -<li><a name="toc_Editor-Basics" href="#Editor-Basics">2 Editor Basics</a> -<ul> -<li><a href="#Entering-Text">2.1 Entering Text</a> -<li><a href="#Special-Functions">2.2 Special Functions</a> -<li><a href="#The-Titlebar">2.3 The Titlebar</a> -<li><a href="#The-Statusbar">2.4 The Statusbar</a> -<li><a href="#Shortcut-Lists">2.5 Shortcut Lists</a> -<li><a href="#Using-the-Mouse">2.6 Using the Mouse</a> -</li></ul> -<li><a name="toc_Online-Help" href="#Online-Help">3 Online Help</a> -<li><a name="toc_Feature-Toggles" href="#Feature-Toggles">4 Feature Toggles</a> -<li><a name="toc_Nanorc-Files" href="#Nanorc-Files">5 Nanorc Files</a> -<li><a name="toc_The-File-Browser" href="#The-File-Browser">6 The File Browser</a> -<li><a name="toc_Pico-Compatibility" href="#Pico-Compatibility">7 Pico Compatibility</a> -<li><a name="toc_Building-and-Configure-Options" href="#Building-and-Configure-Options">8 Building and Configure Options</a> -</li></ul> -</div> -</body></html> +</body> +</html> diff --git a/doc/texinfo/nano.info b/doc/texinfo/nano.info index f4cd7ed0..abb3b3fe 100644 --- a/doc/texinfo/nano.info +++ b/doc/texinfo/nano.info @@ -1,4 +1,4 @@ -This is nano.info, produced by makeinfo version 4.13 from nano.texi. +This is nano.info, produced by makeinfo version 5.1 from nano.texi. INFO-DIR-SECTION Editors START-INFO-DIR-ENTRY @@ -6,9 +6,12 @@ START-INFO-DIR-ENTRY END-INFO-DIR-ENTRY -File: nano.info, Node: Top, Next: Introduction, Prev: (dir), Up: (dir) +File: nano.info, Node: Top, Next: Introduction, Up: (dir) - This manual documents GNU `nano', a small and friendly text editor. +nano Command Manual +******************* + +This manual documents GNU 'nano', a small and friendly text editor. * Menu: @@ -27,10 +30,11 @@ File: nano.info, Node: Introduction, Next: Editor Basics, Prev: Top, Up: Top 1 Introduction ************** -GNU `nano' is a small and friendly text editor. Besides basic text -editing, `nano' offers many extra features like an interactive search -and replace, go to line and column number, auto-indentation, feature -toggles, internationalization support, and filename tab completion. +GNU 'nano' is a small and friendly text editor. Besides basic text +editing, 'nano' offers many extra features, like an interactive +search-and-replace, go-to-line-and-column-number, auto-indentation, +feature toggles, internationalization support, and filename tab +completion. * Menu: @@ -38,30 +42,30 @@ toggles, internationalization support, and filename tab completion. * Command Line Options:: -File: nano.info, Node: Overview, Next: Command Line Options, Prev: Introduction, Up: Introduction +File: nano.info, Node: Overview, Next: Command Line Options, Up: Introduction 1.1 Overview ============ -The original goal for `nano' was a complete bug-for-bug compatible -emulation of Pico, but `nano''s current goal is to be as compatible as +The original goal for 'nano' was a complete bug-for-bug compatible +emulation of Pico, but 'nano''s current goal is to be as compatible as possible while offering a superset of Pico's functionality. See *Note Pico Compatibility::, for more info. - The usual way to invoke `nano' is: + The usual way to invoke 'nano' is: - `nano [OPTION]... [FILE]' + 'nano [OPTION]... [FILE]' But it is also possible to edit several files in a row. Additionally, the cursor can be put on a desired line number by adding this number with a plus sign before any filename, and even in a desired column by adding it with a comma. So the complete synopsis is: - `nano [OPTION]... [[+LINE] FILE]...' + 'nano [OPTION]... [[+LINE] FILE]...' - `nano [OPTION]... [[+,COLUMN] FILE]...' + 'nano [OPTION]... [[+,COLUMN] FILE]...' - `nano [OPTION]... [[+LINE,COLUMN] FILE]...' + 'nano [OPTION]... [[+LINE,COLUMN] FILE]...' Email bug reports to <nano@nano-editor.org>. @@ -71,194 +75,213 @@ File: nano.info, Node: Command Line Options, Prev: Overview, Up: Introduction 1.2 Command Line Options ======================== -`nano' takes the following options from the command line: - -`+LINE,COLUMN' - Start at line number LINE and column number COLUMN (at least one of - which must be specified) instead of the default of line 1, column - 1. +'nano' takes the following options from the command line: -`-?' - Same as `-h, --help'. +'+<line>,<column>' + Start at line number <line> and column number <column> (at least + one of which must be specified) instead of the default of line 1, + column 1. -`-A, --smarthome' +'-A, --smarthome' Make the Home key smarter. When Home is pressed anywhere but at the very beginning of non-whitespace characters on a line, the cursor will jump to that beginning (either forwards or backwards). - If the cursor is already at that position, it will jump to the - true beginning of the line. + If the cursor is already at that position, it will jump to the true + beginning of the line. -`-B, --backup' +'-B, --backup' When saving a file, back up the previous version of it to the current filename suffixed with a ~. -`-C <dir>, --backupdir=<dir>' - Set the directory where `nano' puts unique backup files if file +'-C <dir>, --backupdir=<dir>' + Set the directory where 'nano' puts unique backup files if file backups are enabled. -`-D, --boldtext' +'-D, --boldtext' Use bold text instead of reverse video text. -`-E, --tabstospaces' +'-E, --tabstospaces' Convert typed tabs to spaces. -`-F, --multibuffer' +'-F, --multibuffer' Enable multiple file buffers, if available. -`-H, --historylog' +'-G, --locking' + Enable vim-style file locking when editing files. + +'-H, --historylog' Log search and replace strings to ~/.nano_history, so they can be retrieved in later sessions, if nanorc support is available. -`-I, --ignorercfiles' +'-I, --ignorercfiles' Don't look at SYSCONFDIR/nanorc or ~/.nanorc, if nanorc support is available. -`-K, --rebindkeypad' +'-K, --rebindkeypad' Interpret the numeric keypad keys so that they all work properly. You should only need to use this option if they don't, as mouse support won't work properly with this option enabled. -`-L, --nonewlines' +'-L, --nonewlines' Don't add newlines to the ends of files. -`-N, --noconvert' - Don't convert files from DOS/Mac format. +'-N, --noconvert' + Disable automatic conversion of files from DOS/Mac format. -`-O, --morespace' +'-O, --morespace' Use the blank line below the titlebar as extra editing space. -`-Q <str>, --quotestr=<str>' +'-P, --poslog' + Log and later read back the location of the cursor and place it + there again. + +'-Q <str>, --quotestr=<str>' Set the quoting string for justifying. The default value is - `^([ \t]*[|>:}#])+' + '^([ \t]*[|>:}#])+' if extended regular expression support is available, or "> " - otherwise. Note that `\t' above stands for a literal Tab + otherwise. Note that '\t' above stands for a literal Tab character. -`-R, --restricted' +'-R, --restricted' Restricted mode: don't read or write to any file not specified on - the command line; read any nanorc files; allow suspending; allow a - file to be appended to, prepended to, or saved under a different - name if it already has one; or use backup files or spell checking. - Also accessible by invoking `nano' with any name beginning with - 'r' (e.g. "rnano"). - -`-S, --smooth' - Enable smooth scrolling. Text will scroll line-by-line, instead - of the usual chunk-by-chunk behavior. - -`-T <#cols>, --tabsize=<#cols>' - Set the displayed tab length to #cols columns. The value of #cols - must be greater than 0. The default value is 8. - -`-U, --quickblank' + the command line; don't read any nanorc files; don't allow + suspending; don't allow a file to be appended to, prepended to, or + saved under a different name if it already has one; don't use + backup files nor spell checking. This restricted mode is also + accessible by invoking 'nano' with any name beginning with 'r' + (e.g. "rnano"). + +'-S, --smooth' + Enable smooth scrolling. Text will scroll line-by-line, instead of + the usual chunk-by-chunk behavior. + +'-T <number>, --tabsize=<number>' + Set the displayed tab length to <number> columns. The value of + <number> must be greater than 0. The default value is 8. + +'-U, --quickblank' Do quick statusbar blanking. Statusbar messages will disappear after 1 keystroke instead of 25. Note that -c overrides this. -`-V, --version' +'-V, --version' Show the current version number and exit. -`-W, --wordbounds' +'-W, --wordbounds' Detect word boundaries more accurately by treating punctuation characters as parts of words. -`-Y <str>, --syntax=<str>' - Specify a specific syntax highlighting from the nanorc to use, if - available. See *Note Nanorc Files::, for more info. +'-Y <str>, --syntax=<str>' + Specify a specific syntax from the nanorc to use for highlighting, + if available. See *Note Syntax Highlighting::, for more info. -`-c, --const' +'-c, --const' Constantly display the cursor position and line number on the statusbar. Note that this overrides -U. -`-d, --rebinddelete' +'-d, --rebinddelete' Interpret the Delete key differently so that both Backspace and Delete work properly. You should only need to use this option if Backspace acts like Delete on your system. -`-h, --help' - Show a summary of command line options and exit. +'-h, --help' + Show a summary of command-line options and exit. -`-i, --autoindent' +'-i, --autoindent' Automatically indent new lines to the same number of spaces and tabs as the previous line. -`-k, --cut' - Cut from the current cursor position to the end of the current - line. +'-k, --cut' + Make the 'Cut Text' command (normally ^K) cut from the current + cursor position to the end of the line, instead of cutting the + entire line. -`-l, --nofollow' +'-l, --nofollow' When writing files, if the given file is a symbolic link, it is removed and a new file is created. -`-m, --mouse' +'-m, --mouse' Enable mouse support, if available for your system. When enabled, mouse clicks can be used to place the cursor, set the mark (with a - double click), and execute shortcuts. The mouse will work in the - X Window System, and on the console when gpm is running. - -`-o <dir>, --operatingdir=<dir>' - Set operating directory. Makes `nano' set up something similar to + double click), and execute shortcuts. The mouse will work in the X + Window System, and on the console when gpm is running. Text can + still be selected through dragging by holding down the Shift key. + +'-n, --noread' + Treat any name given on the command line as a new file. This + allows 'nano' to write to named pipes: it will start with a blank + buffer, and will write to the pipe when the user saves the "file". + This way 'nano' can be used as an editor in combination with for + instance 'gpg' without having to write sensitive data to disk + first. + +'-o <dir>, --operatingdir=<dir>' + Set operating directory. Makes 'nano' set up something similar to a chroot. -`-p, --preserve' - Preserve the ^Q (XON) and ^S (XOFF) sequences so data being sent - to the editor can be can be stopped and started. +'-p, --preserve' + Preserve the ^Q (XON) and ^S (XOFF) sequences so data being sent to + the editor can be can be stopped and started. -`-q, --quiet' +'-q, --quiet' Do not report errors in the nanorc file and ask them to be acknowledged by pressing Enter at startup. -`-r <#cols>, --fill=<#cols>' - Wrap lines at column #cols. If this value is 0 or less, wrapping - will occur at the width of the screen less #cols, allowing it to - vary along with the width of the screen if the screen is resized. - The default value is -8. +'-r <number>, --fill=<number>' + Hard-wrap lines at column <number> (by inserting a newline + character). If the given value is 0 or less, wrapping will occur + at the width of the screen minus the given amount, allowing the + wrapping width to vary along with the width of the screen if and + when it is resized. The default value is -8. This option + conflicts with -w - the last one given takes effect. -`-s <prog>, --speller=<prog>' - Invoke the given program as the spell checker. By default, `nano' +'-s <program>, --speller=<program>' + Invoke the given program as the spell checker. By default, 'nano' uses the command specified in the SPELL environment variable, or, if SPELL is not set, its own interactive spell checker that - requires the `spell' program to be installed on your system. + requires the 'spell' program to be installed on your system. -`-t, --tempfile' +'-t, --tempfile' Don't ask whether or not to save the current contents of the file - when exiting, assume yes. This is most useful when using `nano' - as the composer of a mailer program. + when exiting, assume yes. This is most useful when using 'nano' as + the composer of a mailer program. -`-u, --undo' - Enable experimental generic-purpose undo code. By default, the - undo and redo shortcuts are Meta-U and Meta-E, respectively. +'-u, --undo' + Enable the experimental generic-purpose undo/redo code. The + default undo and redo shortcuts are Meta-U and Meta-E, + respectively. -`-v, --view' +'-v, --view' Don't allow the contents of the file to be altered. Note that this option should NOT be used in place of correct file permissions to implement a read-only file. -`-w, --nowrap' - Don't wrap long lines at any length. This option overrides any - value for -r. +'-w, --nowrap' + Don't hard-wrap long lines at any length. This option conflicts + with -r - the last one given takes effect. -`-x, --nohelp' +'-x, --nohelp' Expert Mode: don't show the Shortcut Lists at the bottom of the screen. This affects the location of the statusbar as well, as in Expert Mode it is located at the very bottom of the editor. Note: When accessing the help system, Expert Mode is temporarily - disabled to display the help system navigation keys. + disabled to display the help-system navigation keys. -`-z, --suspend' - Enable `nano''s suspend ability using the system's suspend +'-z, --suspend' + Enable the ability to suspend 'nano' using the system's suspend keystroke (usually ^Z). -`-$, --softwrap' - Enable 'soft wrapping'. `nano' will attempt to display the entire - contents of a line, even if it is longer than the screen width. - Since '$' normally refers to a variable in the Unix shell, you - should specify this option last when using other options (e.g. - 'nano -wS$') or pass it separately (e.g. 'nano -wS -$'). +'-$, --softwrap' + Enable 'soft wrapping'. This will make 'nano' attempt to display + the entire contents of any line, even if it is longer than the + screen width, by continuing it over multiple screen lines. Since + '$' normally refers to a variable in the Unix shell, you should + specify this option last when using other options (e.g. 'nano + -wS$') or pass it separately (e.g. 'nano -wS -$'). -`-a, -b, -e, -f, -g, -j' +'-a, -b, -e, -f, -g, -j' Ignored, for compatibility with Pico. @@ -271,66 +294,103 @@ File: nano.info, Node: Editor Basics, Next: Online Help, Prev: Introduction, * Entering Text:: * Special Functions:: +* The Cutbuffer:: +* The Mark:: * The Titlebar:: * The Statusbar:: * Shortcut Lists:: * Using the Mouse:: -File: nano.info, Node: Entering Text, Next: Special Functions, Prev: Editor Basics, Up: Editor Basics +File: nano.info, Node: Entering Text, Next: Special Functions, Up: Editor Basics 2.1 Entering Text ================= -All key sequences in `nano' are entered using the keyboard. `nano' is -a "modeless" editor. All keys, with the exception of Control and Meta -key sequences, will enter text into the file being edited. +'nano' is a "modeless" editor. All keystrokes, with the exception of +Control and Meta key sequences, enter text into the file being edited. +All key sequences in 'nano' are entered using the keyboard. -File: nano.info, Node: Special Functions, Next: The Titlebar, Prev: Entering Text, Up: Editor Basics +File: nano.info, Node: Special Functions, Next: The Cutbuffer, Prev: Entering Text, Up: Editor Basics 2.2 Special Functions ===================== -Special functions use the Control (Ctrl) key, displayed in the help and -shortcut lists as ^; the Meta key, displayed as M; or the Escape (Esc) -key. +Special functions use the Control key (Ctrl), displayed in the help and +shortcut lists as ^; the Meta key (Alt or Cmd), displayed as M-; or the +Escape key (Esc). * Control key sequences are entered by holding down the Ctrl key and - pressing the desired key, or by pressing the Esc key twice and + pressing the desired key, or by pressing the Esc key twice and then pressing the desired key. - - * Pressing Esc twice and then typing a three-digit number from 000 - to 255 will enter the character with the corresponding value. - + * Pressing the Esc key twice and then typing a three-digit number + from 000 to 255 will enter the character with the corresponding + value. * Meta key sequences are entered by holding down the Meta key - (normally the Alt key) and pressing the desired key, or by - pressing the Esc key once and pressing the desired key. Certain + (normally the Alt key) and pressing the desired key, or by pressing + the Esc key once and then pressing the desired key. Certain operating systems "swallow" the Alt key so that it never reaches - the application; if your operating system does this, you should - use the Esc key to generate Meta key sequences. + the application; if your operating system does this, you should use + the Esc key to generate Meta key sequences. -File: nano.info, Node: The Titlebar, Next: The Statusbar, Prev: Special Functions, Up: Editor Basics +File: nano.info, Node: The Cutbuffer, Next: The Mark, Prev: Special Functions, Up: Editor Basics + +2.3 The Cutbuffer +================= + +Text can be cut from a file, a whole line at a time, by using the 'Cut +Text' command (default key binding: ^K). The cut line is stored in the +cutbuffer. Consecutive strokes of ^K will add each cut line to this +buffer, but a ^K after any other keystroke will overwrite the entire +cutbuffer. + + The contents of the cutbuffer can be pasted back into the file with +the 'Uncut Text' command (default key binding: ^U). + + A line of text can be copied into the cutbuffer (without cutting it) +with the 'Copy Text' command (default key binding: M-6). + + +File: nano.info, Node: The Mark, Next: The Titlebar, Prev: The Cutbuffer, Up: Editor Basics + +2.4 The Mark +============ + +Text can be selected by first 'setting the Mark' (default key bindings: +^6 and M-A) and then moving the cursor to the other end of the portion +to be selected. The selected portion of text will be highlighted in +reverse video (or in bold if you set the boldtext option). This +selection can now be cut or copied in its entirety with a single ^K or +M-6. Or the selection can be used to limit the scope of a +search-and-replace (^\) or spell-checking session (^T). -2.3 The Titlebar + Cutting or copying selected text will toggle the mark off +automatically. If necessary, it can be toggled off manually with +another ^6 or M-A. + + +File: nano.info, Node: The Titlebar, Next: The Statusbar, Prev: The Mark, Up: Editor Basics + +2.5 The Titlebar ================ The titlebar is the line displayed at the top of the editor. There are three sections: left, center and right. The section on the left -displays the version of `nano' being used. The center section displays +displays the version of 'nano' being used. The center section displays the current filename, or "New Buffer" if the file has not yet been -named. The section on the right will display "Modified" if the file -has been modified since it was last saved or opened. +named. The section on the right will display "Modified" if the file has +been modified since it was last saved or opened. - Special modes: When `nano' is in "File browser" mode, the center + Special modes: When 'nano' is in "File browser" mode, the center section will display the current directory instead of the filename. See *Note The File Browser::, for more info. File: nano.info, Node: The Statusbar, Next: Shortcut Lists, Prev: The Titlebar, Up: Editor Basics -2.4 The Statusbar +2.6 The Statusbar ================= The statusbar is the third line from the bottom of the screen, or the @@ -338,12 +398,12 @@ bottom line in Expert Mode. See *Note Expert Mode::, for more info. It shows important and informational messages. Any error messages that occur from using the editor will appear on the statusbar. Any questions that are asked of the user will be asked on the statusbar, and any user -input (search strings, filenames, etc.) will be input on the statusbar. +input (search strings, filenames, etc.) will be input on the statusbar. File: nano.info, Node: Shortcut Lists, Next: Using the Mouse, Prev: The Statusbar, Up: Editor Basics -2.5 Shortcut Lists +2.7 Shortcut Lists ================== The Shortcut Lists are the two lines at the bottom of the screen which @@ -352,13 +412,15 @@ show some of the more commonly used functions in the editor. File: nano.info, Node: Using the Mouse, Prev: Shortcut Lists, Up: Editor Basics -2.6 Using the Mouse +2.8 Using the Mouse =================== When mouse support has been configured and enabled, a single mouse click places the cursor at the indicated position. Clicking a second time in the same position toggles the mark. Clicking in the shortcut list -executes the selected shortcut. +executes the selected shortcut. To be able to select text with the left +button, or paste text with the middle button, hold down the Shift key +during those actions. The mouse will work in the X Window System, and on the console when gpm is running. @@ -369,10 +431,10 @@ File: nano.info, Node: Online Help, Next: Feature Toggles, Prev: Editor Basic 3 Online Help ************* -The online help system in `nano' is available by pressing ^G. It is -fairly self explanatory, documenting the various parts of the editor -and available keystrokes. Navigation is via the ^Y (Page Up) and ^V -(Page Down) keys. ^X exits the help system. +The online help system in 'nano' is available by pressing ^G. It is +fairly self-explanatory, documenting the various parts of the editor and +available keystrokes. Navigation is via the ^Y (Page Up) and ^V (Page +Down) keys. ^X exits the help system. File: nano.info, Node: Feature Toggles, Next: Nanorc Files, Prev: Online Help, Up: Top @@ -381,63 +443,62 @@ File: nano.info, Node: Feature Toggles, Next: Nanorc Files, Prev: Online Help ***************** Toggles allow you to change certain aspects of the editor that would -normally be done via command line options. They are invoked via Meta +normally be done via command-line options. They are invoked via Meta key sequences. See *Note Special Functions::, for more info. The following global toggles are available: -`Backup Files Toggle (Meta-B)' - toggles the -B (`--backup') command line option. +'Backup Files Toggle (Meta-B)' + toggles the -B ('--backup') command line option. -`Constant Cursor Position Display Toggle (Meta-C)' - toggles the -c (`--const') command line option. +'Constant Cursor Position Display Toggle (Meta-C)' + toggles the -c ('--const') command line option. -`Multiple File Buffers Toggle (Meta-F)' - toggles the -F (`--multibuffer') command line option. +'Multiple File Buffers Toggle (Meta-F)' + toggles the -F ('--multibuffer') command line option. -`Smart Home Key Toggle (Meta-H)' - toggles the -A (`--smarthome') command line option. +'Smart Home Key Toggle (Meta-H)' + toggles the -A ('--smarthome') command line option. -`Auto Indent Toggle (Meta-I)' - toggles the -i (`--autoindent') command line option. +'Auto Indent Toggle (Meta-I)' + toggles the -i ('--autoindent') command line option. -`Cut To End Toggle (Meta-K)' - toggles the -k (`--cut') command line option. +'Cut To End Toggle (Meta-K)' + toggles the -k ('--cut') command line option. -`Long Line Wrapping Toggle (Meta-L)' - toggles the -w (`--nowrap') command line option. +'Long Line Wrapping Toggle (Meta-L)' + toggles the -w ('--nowrap') command line option. -`Mouse Support Toggle (Meta-M)' - toggles the -m (`--mouse') command line option. +'Mouse Support Toggle (Meta-M)' + toggles the -m ('--mouse') command line option. -`No Conversion From DOS/Mac Format Toggle (Meta-N)' - toggles the -N (`--noconvert') command line option. +'No Conversion From DOS/Mac Format Toggle (Meta-N)' + toggles the -N ('--noconvert') command line option. -`More Space For Editing Toggle (Meta-O)' - toggles the -O (`--morespace') command line option. +'More Space For Editing Toggle (Meta-O)' + toggles the -O ('--morespace') command line option. -`Whitespace Display Toggle (Meta-P)' +'Whitespace Display Toggle (Meta-P)' toggles whitespace display mode if you have a "whitespace" option - in your nanorc. See *Note Nanorc Files::, for more info. + in your nanorc. See *Note Whitespace::, for more info. -`Tabs to Spaces Toggle (Meta-Q)' - toggles the -E (`--tabstospaces') command line option. +'Tabs to Spaces Toggle (Meta-Q)' + toggles the -E ('--tabstospaces') command line option. -`Smooth Scrolling Toggle (Meta-S)' - toggles the -S (`--smooth') command line option. +'Smooth Scrolling Toggle (Meta-S)' + toggles the -S ('--smooth') command line option. -`Expert/No Help Toggle (Meta-X)' - toggles the -x (`--nohelp') command line option. +'Expert/No Help Toggle (Meta-X)' + toggles the -x ('--nohelp') command line option. -`Color Syntax Highlighting Toggle (Meta-Y)' +'Color Syntax Highlighting Toggle (Meta-Y)' toggles color syntax highlighting if you have color syntaxes in - your nanorc. See *Note Nanorc Files::, for more info. + your nanorc. See *Note Syntax Highlighting::, for more info. -`Suspend Toggle (Meta-Z)' - toggles the -z (`--suspend') command line option. - -`Soft Wrapping Toggle (Meta-$)' - toggles the -$ (`--softwrap') command line option. +'Suspend Toggle (Meta-Z)' + toggles the -z ('--suspend') command line option. +'Soft Wrapping Toggle (Meta-$)' + toggles the -$ ('--softwrap') command line option. File: nano.info, Node: Nanorc Files, Next: The File Browser, Prev: Feature Toggles, Up: Top @@ -445,225 +506,300 @@ File: nano.info, Node: Nanorc Files, Next: The File Browser, Prev: Feature To 5 Nanorc Files ************** -The nanorc files contain the default settings for `nano'. They should -not be in DOS or Mac format. During startup, `nano' will first read -its system-wide settings from SYSCONFDIR/nanorc, and then user-specific -settings from ~/.nanorc. +The nanorc files contain the default settings for 'nano'. They should +be in Unix format, not in DOS or Mac format. During startup, 'nano' +will first read the system-wide settings, from /etc/nanorc, and then the +user-specific settings, from ~/.nanorc. A nanorc file accepts a series of "set" and "unset" commands, which -can be used to configure `nano' on startup without using the command -line options. Additionally, the "syntax", "color", and "icolor" -keywords are used to define syntax highlighting rules for different text -patterns. `nano' will read one command per line. +can be used to configure 'nano' on startup without using command-line +options. Additionally, there are some commands to define syntax +highlighting and to rebind keys - *Note Syntax Highlighting::, and *Note +Rebinding Keys::. 'nano' will read one command per line. - Options in nanorc files take precedence over `nano''s defaults, and -command line options override nanorc settings. Options are also unset + Options in nanorc files take precedence over 'nano''s defaults, and +command-line options override nanorc settings. Options are also unset by default, except for those that take arguments. Quotes inside string parameters don't have to be escaped with backslashes. The last double quote in the string will be treated as its -end. For example, for the "brackets" option, +end. For example, for the "brackets" option, '""')>]}"' will match '"', +''', ')', '>', ']', and '}'. - `""')>]}"' +* Menu: - will match `"', `'', `)', `>', `]', and `}'. +* Settings:: +* Syntax Highlighting:: +* Rebinding Keys:: - The supported commands and arguments are: + +File: nano.info, Node: Settings, Next: Syntax Highlighting, Up: Nanorc Files -`set/unset autoindent' +5.1 Settings +============ + +The supported settings in a nanorc file are: + +'set/unset allow_insecure_backup' + When backing up files, allow the backup to succeed even if its + permissions can't be (re)set due to special OS considerations. You + should NOT enable this option unless you are sure you need it. + +'set/unset autoindent' Use auto-indentation. -`set/unset backup' - Create backup files in "filename~". +'set/unset backup' + When saving a file, back up the previous version of it to the + current filename suffixed with a tilde ('~'). -`set backupdir "directory"' - Set the directory where `nano' puts unique backup files if file +'set backupdir "directory"' + Set the directory where 'nano' puts unique backup files, if file backups are enabled. -`set/unset backwards' +'set/unset backwards' Do backwards searches by default. -`set/unset boldtext' - Use bold text instead of reverse video text. +'set/unset boldtext' + Use bold instead of reverse video for the titlebar, statusbar, key + combos, and selected text. This can be overridden for the first + three by setting the options "titlecolor", "statuscolor", and + "keycolor". -`set brackets "string"' +'set brackets "string"' Set the characters treated as closing brackets when justifying - paragraphs. They cannot contain blank characters. Only closing - punctuation, optionally followed by closing brackets, can end - sentences. The default value is + paragraphs. This may not include blank characters. Only closing + punctuation (see "punct"), optionally followed by the specified + closing brackets, can end sentences. The default value is - `""')>]}"' + '""')>]}"' -`set/unset casesensitive' - Do case sensitive searches by default. +'set/unset casesensitive' + Do case-sensitive searches by default. -`set/unset const' +'set/unset const' Constantly display the cursor position in the status bar. -`set/unset cut' - Use cut to end of line by default, instead of cutting the whole +'set/unset cut' + Use cut-to-end-of-line by default, instead of cutting the whole line. -`set fill "n"' - Wrap lines at column number "n". If "n" is 0 or less, the maximum - line length will be the screen width less "n" columns. The +'set fill "n"' + Hard-wrap lines at column number "n". If "n" is 0 or less, the + maximum line length will be the screen width less "n" columns. The default value is -8. -`set/unset historylog' +'set functioncolor fgcolor,bgcolor' + Specify the color combination to use for the function descriptions + in the two help lines at the bottom of the screen. See "set + titlecolor" for more details. + +'set/unset historylog' Enable ~/.nano_history for saving and reading search/replace strings. -`set matchbrackets "string"' +'set keycolor fgcolor,bgcolor' + Specify the color combination to use for the shortcut key combos in + the two help lines at the bottom of the screen. See "set + titlecolor" for more details. + +'set/unset locking' + Enable vim-style lock-files for when editing files. + +'set matchbrackets "string"' Set the opening and closing brackets that can be found by bracket - searches. They cannot contain blank characters. The former set - must come before the latter set, and both must be in the same - order. The default value is + searches. This may not include blank characters. The opening set + must come before the closing set, and the two sets must be in the + same order. The default value is - `"(<[{)>]}"' + '"(<[{)>]}"' -`set/unset morespace' +'set/unset morespace' Use the blank line below the titlebar as extra editing space. -`set/unset mouse' +'set/unset mouse' Enable mouse support, so that mouse clicks can be used to place the cursor, set the mark (with a double click), or execute shortcuts. -`set/unset multibuffer' +'set/unset multibuffer' Allow inserting files into their own buffers. -`set/unset noconvert' +'set/unset noconvert' Don't convert files from DOS/Mac format. -`set/unset nofollow' +'set/unset nofollow' Don't follow symlinks when writing files. -`set/unset nohelp' +'set/unset nohelp' Don't display the help lists at the bottom of the screen. -`set/unset nonewlines' +'set/unset nonewlines' Don't add newlines to the ends of files. -`set/unset nowrap' - Don't wrap text at all. +'set/unset nowrap' + Don't hard-wrap text at all. -`set operatingdir "directory"' - `nano' will only read and write files inside "directory" and its +'set operatingdir "directory"' + 'nano' will only read and write files inside "directory" and its subdirectories. Also, the current directory is changed to here, so files are inserted from this directory. By default, the operating directory feature is turned off. -`set/unset preserve' +'set/unset poslog' + Save the cursor position of files between editing sessions. + +'set/unset preserve' Preserve the XON and XOFF keys (^Q and ^S). -`set punct "string"' +'set punct "string"' Set the characters treated as closing punctuation when justifying - paragraphs. They cannot contain blank characters. Only closing - punctuation, optionally followed by closing brackets, can end - sentences. The default value is `"!.?"'. + paragraphs. This may not include blank characters. Only the + specified closing punctuation, optionally followed by closing + brackets (see "brackets"), can end sentences. The default value is + '"!.?"'. -`set/unset quickblank' +'set/unset quickblank' Do quick statusbar blanking. Statusbar messages will disappear after 1 keystroke instead of 25. -`set quotestr "string"' +'set/unset quiet' + When set, 'nano' will not report errors in the nanorc file nor ask + them to be acknowledged by pressing Enter at startup. If this + option is used, it should be placed at the top of the file to be + fully effective. + +'set quotestr "string"' The email-quote string, used to justify email-quoted paragraphs. This is an extended regular expression if your system supports them, otherwise a literal string. The default value is - `"^([ \\t]*[#:>\\|}])+"' + '"^([ \\t]*[#:>\\|}])+"' - if you have extended regular expression support, or "> " otherwise. - Note that '\\t' stands for a literal Tab character. + if you have extended regular expression support, and "> " + otherwise. Note that '\\t' stands for a literal Tab character. -`set/unset rebinddelete' +'set/unset rebinddelete' Interpret the Delete key differently so that both Backspace and Delete work properly. You should only need to use this option if Backspace acts like Delete on your system. -`set/unset rebindkeypad' +'set/unset rebindkeypad' Interpret the numeric keypad keys so that they all work properly. You should only need to use this option if they don't, as mouse support won't work properly with this option enabled. -`set/unset regexp' +'set/unset regexp' Do extended regular expression searches by default. -`set/unset smarthome' +'set/unset smarthome' Make the Home key smarter. When Home is pressed anywhere but at the very beginning of non-whitespace characters on a line, the cursor will jump to that beginning (either forwards or backwards). - If the cursor is already at that position, it will jump to the - true beginning of the line. + If the cursor is already at that position, it will jump to the true + beginning of the line. -`set/unset smooth' +'set/unset smooth' Use smooth scrolling by default. -`set/unset softwrap' - Use soft wrapping by default. +'set/unset softwrap' + Enable soft line wrapping for easier viewing of very long lines. -`set speller "spellprog"' +'set speller "spellprog"' Use spelling checker "spellprog" instead of the built-in one, which calls "spell". -`set/unset suspend' - Allow `nano' to be suspended. +'set statuscolor fgcolor,bgcolor' + Specify the color combination to use for the statusbar. See "set + titlecolor" for more details. -`set/unset suspendenable' - If `nano' is allowed to be suspended, allow the suspend key - (usually ^Z) to actually suspend it. +'set/unset suspend' + Allow 'nano' to be suspended. -`set tabsize "n"' +'set tabsize "n"' Use a tab size of "n" columns. The value of "n" must be greater than 0. The default value is 8. -`set/unset tabstospaces' +'set/unset tabstospaces' Convert typed tabs to spaces. -`set/unset tempfile' +'set/unset tempfile' Save automatically on exit, don't prompt. -`set/unset undo' - Enable experimental generic-purpose undo code. +'set titlecolor fgcolor,bgcolor' + Specify the color combination to use for the titlebar. Valid color + names for foreground and background are: white, black, red, blue, + green, yellow, magenta, and cyan. And either "fgcolor" or + ",bgcolor" may be left out. + +'set/unset undo' + Enable the experimental generic-purpose undo/redo code. -`set/unset view' +'set/unset view' Disallow file modification. -`set whitespace "string"' - Set the two characters used to display the first characters of - tabs and spaces. They must be single-column characters. +'set whitespace "string"' + Set the two characters used to indicate the presence of tabs and + spaces. They must be single-column characters. The default pair + for a UTF-8 locale is "»·", and for other locales ">.". -`set/unset wordbounds' +'set/unset wordbounds' Detect word boundaries more accurately by treating punctuation characters as part of a word. -`syntax "str" ["fileregex" ... ]' + +File: nano.info, Node: Syntax Highlighting, Next: Rebinding Keys, Prev: Settings, Up: Nanorc Files + +5.2 Syntax Highlighting +======================= + +Coloring the different syntactic elements of a file can be defined via +the following commands in a nanorc file: + +'syntax "str" ["fileregex" ...]' Defines a syntax named "str" which can be activated via the - -Y/-syntax command line option, or will be automatically activated + -Y/-syntax command-line option, or will be automatically activated if the current filename matches the extended regular expression "fileregex". All following "color" and "icolor" statements will - apply to "syntax" until a new syntax is defined. - - The "none" syntax is reserved; specifying it on the command line - is the same as not having a syntax at all. The "default" syntax - is special: it takes no "fileregex", and applies to files that - don't match any other syntax's "fileregex". - -`color fgcolor,bgcolor "regex" ...' + apply to this "str" syntax until a new syntax is defined. + + The "none" syntax is reserved; specifying it on the command line is + the same as not having a syntax at all. The "default" syntax is + special: it takes no "fileregex", and applies to files that don't + match any other syntax's "fileregex". + +'linter program [arg ...]' + For the currently defined syntax, use the given program to invoke + the linter (this overrides the speller function when defined). + +'header "regex" ...' + For the currently defined syntax, add one or more regexes which + will be compared against the very first line of the file to be + edited, to determine whether this syntax should be used for that + file. + +'magic ["regex" ...]' + For the currently defined syntax, add one or more regexes which + will be compared against the result of querying the magic database + about the file to be edited, to determine whether this syntax + should be used for that file. This functionality only works when + libmagic is installed on the system and will be silently ignored + otherwise. + +'color fgcolor,bgcolor "regex" ...' For the currently defined syntax, display all expressions matching the extended regular expression "regex" with foreground color "fgcolor" and background color "bgcolor", at least one of which - must be specified. Legal colors for foreground and background - color are: white, black, red, blue, green, yellow, magenta, and - cyan. You may use the prefix "bright" to force a stronger color - highlight for the foreground. If your terminal supports - transparency, not specifying a "bgcolor" tells "nano" to attempt - to use a transparent background. - -`icolor fgcolor,bgcolor "regex" ...' + must be specified. Valid colors for foreground and background are: + white, black, red, blue, green, yellow, magenta, and cyan. You may + use the prefix "bright" to get a stronger color highlight for the + foreground. If your terminal supports transparency, not specifying + a "bgcolor" tells 'nano' to attempt to use a transparent + background. + +'icolor fgcolor,bgcolor "regex" ...' Same as above, except that the expression matching is case insensitive. -`color fgcolor,bgcolor start="sr" end="er"' +'color fgcolor,bgcolor start="sr" end="er"' Display expressions which start with the extended regular expression "sr" and end with the extended regular expression "er" with foreground color "fgcolor" and background color "bgcolor", at @@ -672,15 +808,363 @@ end. For example, for the "brackets" option, instances of "sr" after an initial "sr" is found will be highlighted until the first instance of "er". -`icolor fgcolor,bgcolor start="sr" end="er"' +'icolor fgcolor,bgcolor start="sr" end="er"' Same as above, except that the expression matching is case insensitive. -`include "syntaxfile"' +'include "syntaxfile"' Read in self-contained color syntaxes from "syntaxfile". Note that - "syntaxfile" can only contain "syntax", "color", and "icolor" - commands. + "syntaxfile" can only contain the above commands, from "syntax" to + "icolor". +'extendsyntax str directive [arg ...]' + Extend the syntax previously defined as str to include new + information. Allows you to add a new color, icolor, magic, header, + or linter directive to an already defined syntax. Useful when you + want to add to definitions from the system-installed syntax + definitions (which are normally not writable). + + +File: nano.info, Node: Rebinding Keys, Prev: Syntax Highlighting, Up: Nanorc Files + +5.3 Rebinding Keys +================== + +Key bindings may be reassigned via the following two commands in a +nanorc file: + +'bind key function menu' + Rebinds 'key' to 'function' in the context of 'menu' (or in all + menus where the function exists by using 'all'). + +'unbind key menu' + Unbinds 'key' from the specified 'menu' (or from all menus where it + exists by using 'all'). + + The format of 'key' should be one of: + +'^' + followed by an alpha character or the word "Space". Example: '^C' + +'M-' + followed by a printable character or the word "Space". Example: + 'M-C' + +'F' + followed by a numeric value from 1 to 16. Example: 'F10' + + Valid names for the 'function' to be bound are: + +'help' + Invokes the help viewer. + +'cancel' + Cancels the current command. + +'exit' + Exits from the program (or from the help viewer or the file + browser). + +'writeout' + Writes the current buffer to disk. + +'insert' + Inserts a file into the current buffer (or into a new buffer when + multibuffer is enabled). + +'whereis' + Searches for text in the current buffer. + +'searchagain' + Repeats the last search command. + +'replace' + Interactively replaces text within the current buffer. + +'cut' + Cuts and stores the current line (or the marked region). + +'copytext' + Copies the current line (or the marked region) without deleting it. + +'uncut' + Copies the currently stored text into the current buffer at the + current cursor position. + +'mark' + Sets the mark at the current position, to start selecting text. + +'cutrestoffile' + Cuts all text from the cursor position till the end of the buffer. + +'curpos' + Shows the current cursor position: the line, column, and character + positions. + +'wordcount' + Counts the number of words, lines and characters in the current + buffer. + +'speller' + Invokes a spell-checking program (or a linting program, if the + current syntax highlighting defines one). + +'justify' + Justifies the current paragraph. + +'fulljustify' + Justifies the entire current buffer. + +'indent' + Indents (shifts to the right) the currently marked text. + +'unindent' + Unindents (shifts to the left) the currently marked text. + +'left' + Goes left one position (in the editor or browser). + +'right' + Goes right one position (in the editor or browser). + +'up' + Goes one line up (in the editor or browser). + +'down' + Goes one line down (in the editor or browser). + +'scrollup' + Scrolls up one line of text from the current position. + +'scrolldown' + Scrolls down one line of text from the current position. + +'nextword' + Moves the cursor to the beginning of the next word. + +'prevword' + Moves the cursor to the beginning of the previous word. + +'home' + Moves the cursor to the beginning of the current line. + +'end' + Moves the cursor to the end of the current line. + +'beginpara' + Moves the cursor to the beginning of the current paragraph. + +'endpara' + Moves the cursor to the end of the current paragraph. + +'prevpage' + Goes up one screenful. + +'nextpage' + Goes down one screenful. + +'firstline' + Goes to the first line of the file. + +'lastline' + Goes to the last line of the file. + +'gotoline' + Goes to a specific line (and column if specified). + +'findbracket' + Moves the cursor to the bracket (brace, parenthesis, etc.) that + matches (pairs) with the one under the cursor. + +'prevbuf' + Switches to editing/viewing the previous buffer when using + multibuffer mode. + +'nextbuf' + Switches to editing/viewing the next buffer when using multibuffer + mode. + +'verbatim' + Inserts the next character verbatim into the file. + +'tab' + Inserts a tab at the current cursor location. + +'enter' + Inserts a new line below the current one. + +'delete' + Deletes the character under the cursor. + +'backspace' + Deletes the character before the cursor. + +'undo' + Undoes the last performed text action (add text, delete text, etc). + +'redo' + Redoes the last undone action (i.e., it undoes an undo). + +'refresh' + Refreshes the screen. + +'suspend' + Suspends the editor (if the suspending function is enabled, see the + "suspendenable" entry below). + +'casesens' + Toggles case sensitivity in searching (search/replace menus only). + +'regexp' + Toggles whether searching/replacing is based on literal strings or + regular expressions. + +'backwards' + Toggles whether searching/replacing goes forward or backward. + +'prevhistory' + Shows the previous history entry in the prompt menus (e.g. + search). + +'nexthistory' + Shows the next history entry in the prompt menus (e.g. search). + +'dontreplace' + Switches back to searching instead of replacing. + +'gototext' + Searches for files matching a string in the file browser (reading + or writing files). + +'dosformat' + When writing a file, switches to writing a DOS format (CR/LF). + +'macformat' + When writing a file, switches to writing a Mac format. + +'append' + When writing a file, appends to the end instead of overwriting. + +'prepend' + When writing a file, 'prepends' (writes at the beginning) instead + of overwriting. + +'backup' + When writing a file, creates a backup of the current file. + +'firstfile' + Goes to the first file when using the file browser (reading or + writing files). + +'lastfile' + Goes to the last file when using the file browser (reading or + writing files). + +'nohelp' + Toggles the presence of the two-line list of key bindings at the + bottom of the screen. + +'constupdate' + Toggles the constant display of the current line, column, and + character positions. + +'morespace' + Toggles the presence of the blank line which 'separates' the + titlebar from the file text. + +'smoothscroll' + Toggles smooth scrolling (when moving around with the arrow keys). + +'softwrap' + Toggles the displaying of overlong lines on multiple screen lines. + +'whitespacedisplay' + Toggles the showing of whitespace. + +'nosyntax' + Toggles syntax highlighting. + +'smarthome' + Toggles the smartness of the Home key. + +'autoindent' + Toggles whether new lines will contain the same amount of + whitespace as the preceding line. + +'cuttoend' + Toggles whether cutting text will cut the whole line or just from + the current cursor position to the end of the line. + +'nowrap' + Toggles whether long lines will be hard-wrapped to the next line. + +'tabstospaces' + Toggles whether typed tabs will be converted to spaces. + +'backupfile' + Toggles whether a backup will be made of the file to be edited. + +'multibuffer' + Toggles the use of multiple file buffers (if available). + +'mouse' + Toggles mouse support. + +'noconvert' + Toggles automatic conversion of files from DOS/Mac format. + +'suspendenable' + Toggles whether the suspend sequence (normally ^Z) will suspend the + editor window. + + Valid names for 'menu' are: + +'main' + The main editor window where text is entered and edited. + +'search' + The search menu (AKA whereis). + +'replace' + The 'search to replace' menu. + +'replacewith' + The 'replace with' menu, which comes up after 'search to replace'. + +'gotoline' + The 'goto line (and column)' menu. + +'writeout' + The 'write file' menu. + +'insert' + The 'insert file' menu. + +'extcmd' + The menu for inserting output from an external command, reached + from the insert menu. + +'help' + The help-viewer menu. + +'spell' + The interactive spell checker Yes/no menu. + +'linter' + The linter menu. + +'browser' + The file browser for inserting or writing a file. + +'whereisfile' + The 'search for a file' menu in the file browser. + +'gotodir' + The 'go to directory' menu in the file browser. + +'all' + A special name meaning: apply to all menus where this function + exists. File: nano.info, Node: The File Browser, Next: Pico Compatibility, Prev: Nanorc Files, Up: Top @@ -707,52 +1191,52 @@ File: nano.info, Node: Pico Compatibility, Next: Building and Configure Option 7 Pico Compatibility ******************** -`nano' attempts to emulate Pico as closely as possible, but there are +'nano' attempts to emulate Pico as closely as possible, but there are certain differences between the editors: -`Search and Replace History' - As of version 1.1.99pre1 of `nano', text entered as search or +'Search and Replace History' + As of version 1.1.99pre1 of 'nano', text entered as search or replace strings will be stored and can be accessed with the up/down - arrow keys. Previously, `nano' offered a more consistent, but + arrow keys. Previously, 'nano' offered a more consistent, but incompatible with Pico, method for entering search and replace - strings. In the old method, previous entries would be displayed - by default as editable text in front of the cursor, as opposed to + strings. In the old method, previous entries would be displayed by + default as editable text in front of the cursor, as opposed to being bracketed and uneditable as it is in Pico. The old behavior - could be made compatible with Pico via the `-p' option, but recent - versions of Pico use the `-p' option to preserve the XON and XOFF + could be made compatible with Pico via the '-p' option, but recent + versions of Pico use the '-p' option to preserve the XON and XOFF sequences within the editor. Since, with the new method, search and replace strings can still be edited by simply hitting the up arrow key once, the old method was removed completely. -`Writing, Appending, or Prepending Selected Text to Files' +'Writing, Appending, or Prepending Selected Text to Files' Text selected using the marking key (^^) can be written out, - appended, or prepended to a new or existing file using the - WriteOut key (^O). + appended, or prepended to a new or existing file using the WriteOut + key (^O). -`Toggles' +'Toggles' Many options which alter the functionality of the program can be "toggled" on or off using Meta key sequences, meaning the program does not have to be restarted to turn a particular feature of the - editor on or off. Please see the internal help function (^G) for - a list of what functions can be toggled for a particular version - of `nano'. See *Note Feature Toggles::, for more info. - -`Cursor Position Display' - The output of the "Display Cursor Position" in `nano' displays the - given column position, as well as the row and total character - position of the cursor. - -`Interactive Replace and Spell Checker' - It is worth noting that `nano''s replace function is interactive, - i.e. it does not stop after one search string is found and - automatically replace it. The `nano' implementation will pause at - each search string found and query whether to replace this - instance or not. The internal spell checker operates similarly. - Note that there is no way to force these functions to behave in - the Pico fashion. As of version 1.1.99pre1, misspelled words are - sorted and trimmed for uniqueness in the internal spell checker - such that the words 'apple' and 'Apple' will be prompted for - correction separately. + editor on or off. Please see the internal help function (^G) for a + list of what functions can be toggled for a particular version of + 'nano'. See *Note Feature Toggles::, for more info. + +'Cursor Position Display' + The output of the "Display Cursor Position" in 'nano' displays the + current line position of the cursor, as well as the column and + total character position. + +'Interactive Replace and Spell Checker' + It is worth noting that 'nano''s replace function is interactive, + i.e. it does not stop after one search string was found and + automatically replaced. The 'nano' implementation will pause at + each found search string and query whether to replace this instance + or not. The internal spell checker operates similarly. Note that + there is no way to force these functions to behave in the Pico + fashion. As of version 1.1.99pre1, misspelled words are sorted and + trimmed for uniqueness in the internal spell checker such that the + words 'apple' and 'Apple' will be prompted for correction + separately. File: nano.info, Node: Building and Configure Options, Prev: Pico Compatibility, Up: Top @@ -760,125 +1244,131 @@ File: nano.info, Node: Building and Configure Options, Prev: Pico Compatibilit 8 Building and Configure Options ******************************** -Building `nano' from source is fairly straightforward if you are +Building 'nano' from source is fairly straightforward if you are familiar with compiling programs with autoconf support: - * tar xvfz nano-x.y.z.tar.gz (where x.y.z is the version of `nano') - + * tar xvfz nano-x.y.z.tar.gz (where x.y.z is the version of 'nano') * cd nano-x.y.z/ - * ./configure - * make - * make install - The possible options to `./configure' are: + The possible options to './configure' are: -`--disable-browser' +'--disable-browser' Disable the mini file browser when reading or writing files. -`--disable-help' +'--disable-color' + Disable support for syntax coloring of files using the nanorc file. + +'--disable-extra' + Disable extra features. At the moment, this is just + easter-egg-type stuff. + +'--disable-help' Disable the help function. Doing this makes the binary much smaller, but makes it difficult for new users to learn more than very basic things about using the editor. -`--disable-justify' +'--disable-justify' Disable the justify and unjustify functions. -`--disable-mouse' - Disable all mouse functionality. This also disables the -m - command line option, which enables the mouse functionality. +'--disable-libmagic' + Disable the use of the library of magic-number tests (for + determining the file type and thus which syntax to use for + colouring - often the tests on filename extension and header line + will be enough). -`--disable-operatingdir' - Disable setting the operating directory. This also disables the -o - command line option, which sets the operating directory. +'--disable-mouse' + Disable all mouse functionality. This also eliminates the -m + command-line option, which enables the mouse functionality. -`--disable-speller' - Disable use of the spell checker. This also disables the -s - command line option, which allows specifying an alternate spell +'--disable-multibuffer' + Disable support for opening multiple files at a time and switching + between them on the fly. + +'--disable-nanorc' + Disable support for reading the nanorc files at startup. With such + support, you can store custom settings in a system-wide and a + per-user nanorc file rather than having to pass command-line + options to get the desired behavior. See *Note Nanorc Files::, for + more info. + +'--disable-operatingdir' + Disable setting the operating directory. This also eliminates the + -o command-line option, which sets the operating directory. + +'--disable-speller' + Disable use of the spell checker. This also eliminates the -s + command-line option, which allows specifying an alternate spell checker. -`--disable-tabcomp' +'--disable-tabcomp' Disable the tab completion code when reading or writing files. -`--disable-wrapping' - Disable all long line wrapping. This also eliminates the -w - command line option, which enables long line wrapping. +'--disable-wrapping' + Disable hard-wrapping of overlong lines. This also eliminates the + -w command-line option, which enables long-line wrapping. -`--enable-tiny' +'--enable-tiny' This option disables all the above. It also disables some of the - larger internals of the editor, like the marking code and the cut - to end of line code. It also disables the function toggles. + larger internals of the editor, like the marking code and the + cut-to-end-of-line code. It also disables the function toggles. -`--enable-debug' +'--enable-debug' Enable support for runtime debug output. This can get pretty - messy, so chances are you only want this feature to work on the - nano source. - -`--enable-extra' - Enable extra features. At the moment, this is just easter egg-type - stuff. - -`--enable-color' - Enable support for syntax coloring of files using the nanorc file. - This enables nanorc support as well. + messy, so chances are you only want this feature when you're + working on the nano source. -`--enable-multibuffer' - Enable support for opening multiple files at a time and switching - between them on the fly. - -`--enable-nanorc' - Enable support for reading the nanorc file at startup. You can - store custom settings in the nanorc file rather than having to - pass command line options to get desired behavior. See *Note - Nanorc Files::, for more info. - -`--enable-all' - Shortcut for enabling the above four features (extra, color, - multibuffer, and nanorc). - -`--disable-nls' +'--disable-nls' Disables Native Language support. This will disable use of the - available GNU `nano' translations. + available GNU 'nano' translations. -`--disable-wrapping-as-root' - Disable long line wrapping by default when nano is run as root. +'--disable-wrapping-as-root' + Disable hard-wrapping of overlong lines by default when 'nano' is + run as root. -`--enable-utf8' +'--enable-utf8' Enable support for reading and writing Unicode files. This will - require either a wide version of curses, or a UTF-8-enabled - version of Slang. - -`--disable-utf8' - Disable support for reading and writing Unicode files. + require either a wide version of curses, or a UTF-8-enabled version + of Slang. -`--with-slang' - Compiling `nano' with Slang is supported, and will make the binary - notably smaller than if compiled with ncurses or other curses - libraries. +'--disable-utf8' + Disable support for reading and writing Unicode files. Normally + the configure script auto-detects whether to enable UTF-8 support + or not. You can use this or the previous option to override that + detection. +'--with-slang' + Compile 'nano' against Slang instead of against ncurses or other + curses libraries. Tag Table: -Node: Top200 -Node: Introduction527 -Node: Overview966 -Node: Command Line Options1871 -Ref: Expert Mode7858 -Node: Editor Basics8745 -Node: Entering Text8994 -Node: Special Functions9342 -Node: The Titlebar10346 -Node: The Statusbar11071 -Node: Shortcut Lists11643 -Node: Using the Mouse11923 -Node: Online Help12383 -Node: Feature Toggles12760 -Node: Nanorc Files14867 -Node: The File Browser23472 -Node: Pico Compatibility24294 -Node: Building and Configure Options26950 +Node: Top199 +Node: Introduction550 +Node: Overview990 +Node: Command Line Options1874 +Ref: Expert Mode8834 +Node: Editor Basics9791 +Node: Entering Text10071 +Node: Special Functions10397 +Node: The Cutbuffer11437 +Node: The Mark12124 +Node: The Titlebar12861 +Node: The Statusbar13577 +Node: Shortcut Lists14150 +Node: Using the Mouse14430 +Node: Online Help15023 +Node: Feature Toggles15399 +Node: Nanorc Files17510 +Node: Settings18732 +Ref: Whitespace25594 +Node: Syntax Highlighting25952 +Node: Rebinding Keys29553 +Node: The File Browser37504 +Node: Pico Compatibility38326 +Node: Building and Configure Options40986 End Tag Table diff --git a/doc/texinfo/nano.texi b/doc/texinfo/nano.texi index fe12428c..62d146ed 100644 --- a/doc/texinfo/nano.texi +++ b/doc/texinfo/nano.texi @@ -8,8 +8,8 @@ @c Run 'makeinfo' rather than 'texinfo-format-buffer'. @smallbook @set EDITION 0.1 -@set VERSION 2.2.0 -@set UPDATED 30 Nov 2009 +@set VERSION 2.3.3 +@set UPDATED May 2014 @dircategory Editors @direntry @@ -23,7 +23,7 @@ @titlepage @title GNU @code{nano} @subtitle a small and friendly text editor. -@subtitle version 2.2.0 +@subtitle version 2.3.3 @author Chris Allegretta @page @@ -32,9 +32,9 @@ This manual documents GNU @code{nano}, a small and friendly text editor. This manual is part of the GNU @code{nano} distribution.@* -@sp4 +@sp 4 Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, -2008, 2009 Free Software Foundation, Inc. +2009, 2014 Free Software Foundation, Inc. This document is dual-licensed. You may distribute and/or modify it under the terms of either of the following licenses: @@ -54,7 +54,9 @@ You may contact the author by e-mail: @email{chrisa@@asty.org}@* @end titlepage -@node Top, Introduction, (dir), (dir) + +@node Top +@top This manual documents GNU @code{nano}, a small and friendly text editor. @@ -70,12 +72,13 @@ editor. * Building and Configure Options:: @end menu -@node Introduction, Editor Basics, Top, Top + +@node Introduction @chapter Introduction GNU @code{nano} is a small and friendly text editor. Besides basic text -editing, @code{nano} offers many extra features like an interactive -search and replace, go to line and column number, auto-indentation, +editing, @code{nano} offers many extra features, like an interactive +search-and-replace, go-to-line-and-column-number, auto-indentation, feature toggles, internationalization support, and filename tab completion. @@ -84,7 +87,7 @@ completion. * Command Line Options:: @end menu -@node Overview, Command Line Options, Introduction, Introduction +@node Overview @section Overview The original goal for @code{nano} was a complete bug-for-bug compatible @@ -113,19 +116,16 @@ adding it with a comma. So the complete synopsis is: Email bug reports to @email{nano@@nano-editor.org}. -@node Command Line Options, , Overview, Introduction +@node Command Line Options @section Command Line Options @code{nano} takes the following options from the command line: @table @code -@item +LINE,COLUMN -Start at line number LINE and column number COLUMN (at least one of +@item +<line>,<column> +Start at line number <line> and column number <column> (at least one of which must be specified) instead of the default of line 1, column 1. -@item -? -Same as @code{-h, --help}. - @item -A, --smarthome Make the Home key smarter. When Home is pressed anywhere but at the very beginning of non-whitespace characters on a line, the cursor will @@ -150,6 +150,9 @@ Convert typed tabs to spaces. @item -F, --multibuffer Enable multiple file buffers, if available. +@item -G, --locking +Enable vim-style file locking when editing files. + @item -H, --historylog Log search and replace strings to ~/.nano_history, so they can be retrieved in later sessions, if nanorc support is available. @@ -167,11 +170,15 @@ won't work properly with this option enabled. Don't add newlines to the ends of files. @item -N, --noconvert -Don't convert files from DOS/Mac format. +Disable automatic conversion of files from DOS/Mac format. @item -O, --morespace Use the blank line below the titlebar as extra editing space. +@item -P, --poslog +Log and later read back the location of the cursor and place it +there again. + @item -Q <str>, --quotestr=<str> Set the quoting string for justifying. The default value is @@ -184,18 +191,19 @@ Note that @code{\t} above stands for a literal Tab character. @item -R, --restricted Restricted mode: don't read or write to any file not specified on the -command line; read any nanorc files; allow suspending; allow a file to -be appended to, prepended to, or saved under a different name if it -already has one; or use backup files or spell checking. Also accessible -by invoking @code{nano} with any name beginning with 'r' (e.g. "rnano"). +command line; don't read any nanorc files; don't allow suspending; don't +allow a file to be appended to, prepended to, or saved under a different +name if it already has one; don't use backup files nor spell checking. +This restricted mode is also accessible by invoking @code{nano} with +any name beginning with 'r' (e.g. "rnano"). @item -S, --smooth Enable smooth scrolling. Text will scroll line-by-line, instead of the usual chunk-by-chunk behavior. -@item -T <#cols>, --tabsize=<#cols> -Set the displayed tab length to #cols columns. The value of #cols must -be greater than 0. The default value is 8. +@item -T <number>, --tabsize=<number> +Set the displayed tab length to <number> columns. The value of <number> +must be greater than 0. The default value is 8. @item -U, --quickblank Do quick statusbar blanking. Statusbar messages will disappear after 1 @@ -209,8 +217,8 @@ Detect word boundaries more accurately by treating punctuation characters as parts of words. @item -Y <str>, --syntax=<str> -Specify a specific syntax highlighting from the nanorc to use, if -available. See @xref{Nanorc Files}, for more info. +Specify a specific syntax from the nanorc to use for highlighting, if +available. See @xref{Syntax Highlighting}, for more info. @item -c, --const Constantly display the cursor position and line number on the statusbar. @@ -222,14 +230,15 @@ work properly. You should only need to use this option if Backspace acts like Delete on your system. @item -h, --help -Show a summary of command line options and exit. +Show a summary of command-line options and exit. @item -i, --autoindent Automatically indent new lines to the same number of spaces and tabs as the previous line. @item -k, --cut -Cut from the current cursor position to the end of the current line. +Make the 'Cut Text' command (normally ^K) cut from the current cursor +position to the end of the line, instead of cutting the entire line. @item -l, --nofollow When writing files, if the given file is a symbolic link, it is removed @@ -239,7 +248,15 @@ and a new file is created. Enable mouse support, if available for your system. When enabled, mouse clicks can be used to place the cursor, set the mark (with a double click), and execute shortcuts. The mouse will work in the X Window -System, and on the console when gpm is running. +System, and on the console when gpm is running. Text can still be +selected through dragging by holding down the Shift key. + +@item -n, --noread +Treat any name given on the command line as a new file. This allows +@code{nano} to write to named pipes: it will start with a blank buffer, +and will write to the pipe when the user saves the "file". This way +@code{nano} can be used as an editor in combination with for instance +@code{gpg} without having to write sensitive data to disk first. @item -o <dir>, --operatingdir=<dir> Set operating directory. Makes @code{nano} set up something similar to @@ -253,13 +270,15 @@ editor can be can be stopped and started. Do not report errors in the nanorc file and ask them to be acknowledged by pressing Enter at startup. -@item -r <#cols>, --fill=<#cols> -Wrap lines at column #cols. If this value is 0 or less, wrapping will -occur at the width of the screen less #cols, allowing it to vary along -with the width of the screen if the screen is resized. The default -value is -8. +@item -r <number>, --fill=<number> +Hard-wrap lines at column <number> (by inserting a newline character). +If the given value is 0 or less, wrapping will occur at the width of +the screen minus the given amount, allowing the wrapping width to +vary along with the width of the screen if and when it is resized. +The default value is -8. This option conflicts with -w -- the last +one given takes effect. -@item -s <prog>, --speller=<prog> +@item -s <program>, --speller=<program> Invoke the given program as the spell checker. By default, @code{nano} uses the command specified in the SPELL environment variable, or, if SPELL is not set, its own interactive spell checker that requires the @@ -271,8 +290,8 @@ exiting, assume yes. This is most useful when using @code{nano} as the composer of a mailer program. @item -u, --undo -Enable experimental generic-purpose undo code. By default, the undo and -redo shortcuts are Meta-U and Meta-E, respectively. +Enable the experimental generic-purpose undo/redo code. The default undo +and redo shortcuts are Meta-U and Meta-E, respectively. @item -v, --view Don't allow the contents of the file to be altered. Note that this @@ -280,8 +299,8 @@ option should NOT be used in place of correct file permissions to implement a read-only file. @item -w, --nowrap -Don't wrap long lines at any length. This option overrides any value -for -r. +Don't hard-wrap long lines at any length. This option conflicts with +-r -- the last one given takes effect. @anchor{Expert Mode} @item -x, --nohelp @@ -290,68 +309,99 @@ This affects the location of the statusbar as well, as in Expert Mode it is located at the very bottom of the editor. Note: When accessing the help system, Expert Mode is temporarily -disabled to display the help system navigation keys. +disabled to display the help-system navigation keys. @item -z, --suspend -Enable @code{nano}'s suspend ability using the system's suspend +Enable the ability to suspend @code{nano} using the system's suspend keystroke (usually ^Z). @item -$, --softwrap -Enable 'soft wrapping'. @code{nano} will attempt to display the entire -contents of a line, even if it is longer than the screen width. Since +Enable 'soft wrapping'. This will make @code{nano} attempt to display the +entire contents of any line, even if it is longer than the screen width, by +continuing it over multiple screen lines. Since '$' normally refers to a variable in the Unix shell, you should specify -this option last when using other options (e.g. 'nano -wS$') or pass it -separately (e.g. 'nano -wS -$'). +this option last when using other options (e.g. @code{nano -wS$}) or pass it +separately (e.g. @code{nano -wS -$}). @item -a, -b, -e, -f, -g, -j Ignored, for compatibility with Pico. @end table -@node Editor Basics, Online Help, Introduction, Top +@node Editor Basics @chapter Editor Basics + @menu * Entering Text:: * Special Functions:: +* The Cutbuffer:: +* The Mark:: * The Titlebar:: * The Statusbar:: * Shortcut Lists:: * Using the Mouse:: @end menu -@node Entering Text, Special Functions, Editor Basics, Editor Basics +@node Entering Text @section Entering Text +@code{nano} is a "modeless" editor. All keystrokes, with the exception +of Control and Meta key sequences, enter text into the file being edited. All key sequences in @code{nano} are entered using the keyboard. -@code{nano} is a "modeless" editor. All keys, with the exception of -Control and Meta key sequences, will enter text into the file being -edited. -@node Special Functions, The Titlebar, Entering Text, Editor Basics +@node Special Functions @section Special Functions -Special functions use the Control (Ctrl) key, displayed in the help and -shortcut lists as ^; the Meta key, displayed as M; or the Escape (Esc) -key. +Special functions use the Control key (Ctrl), displayed in the help and +shortcut lists as ^; the Meta key (Alt or Cmd), displayed as M-; or the +Escape key (Esc). @itemize @bullet @item Control key sequences are entered by holding down the Ctrl key and -pressing the desired key, or by pressing the Esc key twice and pressing -the desired key. +pressing the desired key, or by pressing the Esc key twice and then +pressing the desired key. @item -Pressing Esc twice and then typing a three-digit number from 000 to 255 -will enter the character with the corresponding value. +Pressing the Esc key twice and then typing a three-digit number from +000 to 255 will enter the character with the corresponding value. @item Meta key sequences are entered by holding down the Meta key (normally the Alt key) and pressing the desired key, or by pressing the Esc key -once and pressing the desired key. Certain operating systems "swallow" +once and then pressing the desired key. Certain operating systems "swallow" the Alt key so that it never reaches the application; if your operating system does this, you should use the Esc key to generate Meta key sequences. @end itemize -@node The Titlebar, The Statusbar, Special Functions, Editor Basics +@node The Cutbuffer +@section The Cutbuffer + +Text can be cut from a file, a whole line at a time, by using the 'Cut Text' +command (default key binding: ^K). The cut line is stored in the cutbuffer. +Consecutive strokes of ^K will add each cut line to this buffer, but a ^K +after any other keystroke will overwrite the entire cutbuffer. + +The contents of the cutbuffer can be pasted back into the file with the +'Uncut Text' command (default key binding: ^U). + +A line of text can be copied into the cutbuffer (without cutting it) with +the 'Copy Text' command (default key binding: M-6). + +@node The Mark +@section The Mark + +Text can be selected by first 'setting the Mark' (default key bindings: +^6 and M-A) and then moving the cursor to the other end of the portion +to be selected. The selected portion of text will be highlighted in +reverse video (or in bold if you set the boldtext option). +This selection can now be cut or copied in its entirety with a single +^K or M-6. Or the selection can be used to limit the scope of a +search-and-replace (^\) or spell-checking session (^T). + +Cutting or copying selected text will toggle the mark off automatically. +If necessary, it can be toggled off manually with another ^6 or M-A. + +@node The Titlebar @section The Titlebar The titlebar is the line displayed at the top of the editor. There are @@ -365,7 +415,7 @@ Special modes: When @code{nano} is in "File browser" mode, the center section will display the current directory instead of the filename. See @xref{The File Browser}, for more info. -@node The Statusbar, Shortcut Lists, The Titlebar, Editor Basics +@node The Statusbar @section The Statusbar The statusbar is the third line from the bottom of the screen, or the @@ -375,38 +425,40 @@ occur from using the editor will appear on the statusbar. Any questions that are asked of the user will be asked on the statusbar, and any user input (search strings, filenames, etc.) will be input on the statusbar. -@node Shortcut Lists, Using the Mouse, The Statusbar, Editor Basics +@node Shortcut Lists @section Shortcut Lists The Shortcut Lists are the two lines at the bottom of the screen which show some of the more commonly used functions in the editor. -@node Using the Mouse, , Shortcut Lists, Editor Basics +@node Using the Mouse @section Using the Mouse When mouse support has been configured and enabled, a single mouse click places the cursor at the indicated position. Clicking a second time in the same position toggles the mark. Clicking in the shortcut list -executes the selected shortcut. +executes the selected shortcut. To be able to select text with the +left button, or paste text with the middle button, hold down the +Shift key during those actions. The mouse will work in the X Window System, and on the console when gpm is running. -@node Online Help, Feature Toggles, Editor Basics, Top +@node Online Help @chapter Online Help The online help system in @code{nano} is available by pressing ^G. -It is fairly self explanatory, documenting the various parts of the +It is fairly self-explanatory, documenting the various parts of the editor and available keystrokes. Navigation is via the ^Y (Page Up) and ^V (Page Down) keys. ^X exits the help system. -@node Feature Toggles, Nanorc Files, Online Help, Top +@node Feature Toggles @chapter Feature Toggles Toggles allow you to change certain aspects of the editor that would -normally be done via command line options. They are invoked via Meta +normally be done via command-line options. They are invoked via Meta key sequences. See @xref{Special Functions}, for more info. The following global toggles are available: @@ -444,7 +496,7 @@ toggles the -O (@code{--morespace}) command line option. @item Whitespace Display Toggle (Meta-P) toggles whitespace display mode if you have a "whitespace" option in -your nanorc. See @xref{Nanorc Files}, for more info. +your nanorc. See @xref{Whitespace}, for more info. @item Tabs to Spaces Toggle (Meta-Q) toggles the -E (@code{--tabstospaces}) command line option. @@ -457,7 +509,7 @@ toggles the -x (@code{--nohelp}) command line option. @item Color Syntax Highlighting Toggle (Meta-Y) toggles color syntax highlighting if you have color syntaxes in your -nanorc. See @xref{Nanorc Files}, for more info. +nanorc. See @xref{Syntax Highlighting}, for more info. @item Suspend Toggle (Meta-Z) toggles the -z (@code{--suspend}) command line option. @@ -468,87 +520,111 @@ toggles the -$ (@code{--softwrap}) command line option. @end table -@node Nanorc Files, The File Browser, Feature Toggles, Top +@node Nanorc Files @chapter Nanorc Files The nanorc files contain the default settings for @code{nano}. They -should not be in DOS or Mac format. During startup, @code{nano} will -first read its system-wide settings from SYSCONFDIR/nanorc, and then -user-specific settings from ~/.nanorc. +should be in Unix format, not in DOS or Mac format. During startup, +@code{nano} will first read the system-wide settings, from /etc/nanorc, +and then the user-specific settings, from ~/.nanorc. A nanorc file accepts a series of "set" and "unset" commands, which can -be used to configure @code{nano} on startup without using the command -line options. Additionally, the "syntax", "color", and "icolor" -keywords are used to define syntax highlighting rules for different text -patterns. @code{nano} will read one command per line. +be used to configure @code{nano} on startup without using command-line +options. Additionally, there are some commands to define syntax highlighting +and to rebind keys -- @xref{Syntax Highlighting}, and @xref{Rebinding Keys}. +@code{nano} will read one command per line. Options in nanorc files take precedence over @code{nano}'s defaults, and -command line options override nanorc settings. Options are also unset +command-line options override nanorc settings. Options are also unset by default, except for those that take arguments. Quotes inside string parameters don't have to be escaped with backslashes. The last double quote in the string will be treated as its -end. For example, for the "brackets" option, +end. For example, for the "brackets" option, @code{""')>]@}"} will match +@code{"}, @code{'}, @code{)}, @code{>}, @code{]}, and @code{@}}. -@quotation -@code{""')>]@}"} -@end quotation +@menu +* Settings:: +* Syntax Highlighting:: +* Rebinding Keys:: +@end menu -will match @code{"}, @code{'}, @code{)}, @code{>}, @code{]}, and -@code{@}}. +@node Settings +@section Settings -The supported commands and arguments are: +The supported settings in a nanorc file are: @table @code +@item set/unset allow_insecure_backup +When backing up files, allow the backup to succeed even if its +permissions can't be (re)set due to special OS considerations. +You should NOT enable this option unless you are sure you need it. + @item set/unset autoindent Use auto-indentation. @item set/unset backup -Create backup files in "filename~". +When saving a file, back up the previous version of it to the current +filename suffixed with a tilde (@code{~}). @item set backupdir "directory" -Set the directory where @code{nano} puts unique backup files if file +Set the directory where @code{nano} puts unique backup files, if file backups are enabled. @item set/unset backwards Do backwards searches by default. @item set/unset boldtext -Use bold text instead of reverse video text. +Use bold instead of reverse video for the titlebar, statusbar, key combos, +and selected text. This can be overridden for the first three by setting +the options "titlecolor", "statuscolor", and "keycolor". @item set brackets "string" Set the characters treated as closing brackets when justifying -paragraphs. They cannot contain blank characters. Only closing -punctuation, optionally followed by closing brackets, can end sentences. -The default value is +paragraphs. This may not include blank characters. Only closing +punctuation (see "punct"), optionally followed by the specified +closing brackets, can end sentences. The default value is @quotation @code{""')>]@}"} @end quotation @item set/unset casesensitive -Do case sensitive searches by default. +Do case-sensitive searches by default. @item set/unset const Constantly display the cursor position in the status bar. @item set/unset cut -Use cut to end of line by default, instead of cutting the whole line. +Use cut-to-end-of-line by default, instead of cutting the whole line. @item set fill "n" -Wrap lines at column number "n". If "n" is 0 or less, the maximum line +Hard-wrap lines at column number "n". If "n" is 0 or less, the maximum line length will be the screen width less "n" columns. The default value is -8. +@item set functioncolor fgcolor,bgcolor +Specify the color combination to use for the function descriptions +in the two help lines at the bottom of the screen. +See "set titlecolor" for more details. + @item set/unset historylog Enable ~/.nano_history for saving and reading search/replace strings. +@item set keycolor fgcolor,bgcolor +Specify the color combination to use for the shortcut key combos +in the two help lines at the bottom of the screen. +See "set titlecolor" for more details. + +@item set/unset locking +Enable vim-style lock-files for when editing files. + @item set matchbrackets "string" Set the opening and closing brackets that can be found by bracket -searches. They cannot contain blank characters. The former set must -come before the latter set, and both must be in the same order. The -default value is +searches. This may not include blank characters. The opening set must +come before the closing set, and the two sets must be in the same order. +The default value is @quotation @code{"(<[@{)>]@}"} @@ -577,7 +653,7 @@ Don't display the help lists at the bottom of the screen. Don't add newlines to the ends of files. @item set/unset nowrap -Don't wrap text at all. +Don't hard-wrap text at all. @item set operatingdir "directory" @code{nano} will only read and write files inside "directory" and its @@ -585,19 +661,27 @@ subdirectories. Also, the current directory is changed to here, so files are inserted from this directory. By default, the operating directory feature is turned off. +@item set/unset poslog +Save the cursor position of files between editing sessions. + @item set/unset preserve Preserve the XON and XOFF keys (^Q and ^S). @item set punct "string" Set the characters treated as closing punctuation when justifying -paragraphs. They cannot contain blank characters. Only closing -punctuation, optionally followed by closing brackets, can end sentences. -The default value is @code{"!.?"}. +paragraphs. This may not include blank characters. Only the +specified closing punctuation, optionally followed by closing brackets +(see "brackets"), can end sentences. The default value is @code{"!.?"}. @item set/unset quickblank Do quick statusbar blanking. Statusbar messages will disappear after 1 keystroke instead of 25. +@item set/unset quiet +When set, @code{nano} will not report errors in the nanorc file nor ask them +to be acknowledged by pressing Enter at startup. If this option is used, it +should be placed at the top of the file to be fully effective. + @item set quotestr "string" The email-quote string, used to justify email-quoted paragraphs. This is an extended regular expression if your system supports them, @@ -607,7 +691,7 @@ otherwise a literal string. The default value is @code{"^([ \\t]*[#:>\\|@}])+"} @end quotation -if you have extended regular expression support, or "> " otherwise. +if you have extended regular expression support, and "> " otherwise. Note that '\\t' stands for a literal Tab character. @item set/unset rebinddelete @@ -634,19 +718,19 @@ line. Use smooth scrolling by default. @item set/unset softwrap -Use soft wrapping by default. +Enable soft line wrapping for easier viewing of very long lines. @item set speller "spellprog" Use spelling checker "spellprog" instead of the built-in one, which calls "spell". +@item set statuscolor fgcolor,bgcolor +Specify the color combination to use for the statusbar. +See "set titlecolor" for more details. + @item set/unset suspend Allow @code{nano} to be suspended. -@item set/unset suspendenable -If @code{nano} is allowed to be suspended, allow the suspend key -(usually ^Z) to actually suspend it. - @item set tabsize "n" Use a tab size of "n" columns. The value of "n" must be greater than 0. The default value is 8. @@ -657,40 +741,74 @@ Convert typed tabs to spaces. @item set/unset tempfile Save automatically on exit, don't prompt. +@item set titlecolor fgcolor,bgcolor +Specify the color combination to use for the titlebar. +Valid color names for foreground and background are: +white, black, red, blue, green, yellow, magenta, and cyan. +And either "fgcolor" or ",bgcolor" may be left out. + @item set/unset undo -Enable experimental generic-purpose undo code. +Enable the experimental generic-purpose undo/redo code. @item set/unset view Disallow file modification. +@anchor{Whitespace} @item set whitespace "string" -Set the two characters used to display the first characters of tabs and -spaces. They must be single-column characters. +Set the two characters used to indicate the presence of tabs and +spaces. They must be single-column characters. The default pair +for a UTF-8 locale is "»·", and for other locales ">.". @item set/unset wordbounds Detect word boundaries more accurately by treating punctuation characters as part of a word. -@item syntax "str" ["fileregex" @dots{} ] +@end table + +@node Syntax Highlighting +@section Syntax Highlighting + +Coloring the different syntactic elements of a file can be defined +via the following commands in a nanorc file: + +@table @code + +@item syntax "str" ["fileregex" @dots{}] Defines a syntax named "str" which can be activated via the -Y/--syntax -command line option, or will be automatically activated if the current +command-line option, or will be automatically activated if the current filename matches the extended regular expression "fileregex". All -following "color" and "icolor" statements will apply to "syntax" until a -new syntax is defined. +following "color" and "icolor" statements will apply to this "str" +syntax until a new syntax is defined. The "none" syntax is reserved; specifying it on the command line is the same as not having a syntax at all. The "default" syntax is special: it takes no "fileregex", and applies to files that don't match any other syntax's "fileregex". +@item linter program [arg @dots{}] +For the currently defined syntax, use the given program to invoke the +linter (this overrides the speller function when defined). + +@item header "regex" @dots{} +For the currently defined syntax, add one or more regexes which will +be compared against the very first line of the file to be edited, +to determine whether this syntax should be used for that file. + +@item magic ["regex" @dots{}] +For the currently defined syntax, add one or more regexes which will be +compared against the result of querying the magic database about the file +to be edited, to determine whether this syntax should be used for that +file. This functionality only works when libmagic is installed on the +system and will be silently ignored otherwise. + @item color fgcolor,bgcolor "regex" @dots{} For the currently defined syntax, display all expressions matching the extended regular expression "regex" with foreground color "fgcolor" and background color "bgcolor", at least one of which must be specified. -Legal colors for foreground and background color are: white, black, red, +Valid colors for foreground and background are: white, black, red, blue, green, yellow, magenta, and cyan. You may use the prefix "bright" -to force a stronger color highlight for the foreground. If your -terminal supports transparency, not specifying a "bgcolor" tells "nano" +to get a stronger color highlight for the foreground. If your +terminal supports transparency, not specifying a "bgcolor" tells @code{nano} to attempt to use a transparent background. @item icolor fgcolor,bgcolor "regex" @dots{} @@ -709,12 +827,357 @@ Same as above, except that the expression matching is case insensitive. @item include "syntaxfile" Read in self-contained color syntaxes from "syntaxfile". Note that -"syntaxfile" can only contain "syntax", "color", and "icolor" commands. +"syntaxfile" can only contain the above commands, from "syntax" to +"icolor". + +@item extendsyntax str directive [arg @dots{}] +Extend the syntax previously defined as str to include new information. +Allows you to add a new color, icolor, magic, header, or linter directive +to an already defined syntax. Useful when you want to add to definitions +from the system-installed syntax definitions (which are normally not writable). + +@end table + +@node Rebinding Keys +@section Rebinding Keys + +Key bindings may be reassigned via the following two commands in a +nanorc file: + +@table @code + +@item bind key function menu +Rebinds @code{key} to @code{function} in the context of @code{menu} +(or in all menus where the function exists by using @code{all}). + +@item unbind key menu +Unbinds @code{key} from the specified @code{menu} +(or from all menus where it exists by using @code{all}). + +@end table + +The format of @code{key} should be one of: + +@table @code + +@item ^ +followed by an alpha character or the word "Space". +Example: @code{^C} + +@item M- +followed by a printable character or the word "Space". +Example: @code{M-C} + +@item F +followed by a numeric value from 1 to 16. +Example: @code{F10} + +@end table + +Valid names for the @code{function} to be bound are: + +@table @code + +@item help +Invokes the help viewer. + +@item cancel +Cancels the current command. + +@item exit +Exits from the program (or from the help viewer or the file browser). + +@item writeout +Writes the current buffer to disk. + +@item insert +Inserts a file into the current buffer (or into a new buffer when multibuffer +is enabled). + +@item whereis +Searches for text in the current buffer. + +@item searchagain +Repeats the last search command. + +@item replace +Interactively replaces text within the current buffer. + +@item cut +Cuts and stores the current line (or the marked region). + +@item copytext +Copies the current line (or the marked region) without deleting it. + +@item uncut +Copies the currently stored text into the current buffer at the +current cursor position. + +@item mark +Sets the mark at the current position, to start selecting text. + +@item cutrestoffile +Cuts all text from the cursor position till the end of the buffer. + +@item curpos +Shows the current cursor position: the line, column, and character positions. + +@item wordcount +Counts the number of words, lines and characters in the current buffer. + +@item speller +Invokes a spell-checking program (or a linting program, if the current +syntax highlighting defines one). + +@item justify +Justifies the current paragraph. + +@item fulljustify +Justifies the entire current buffer. + +@item indent +Indents (shifts to the right) the currently marked text. + +@item unindent +Unindents (shifts to the left) the currently marked text. + +@item left +Goes left one position (in the editor or browser). + +@item right +Goes right one position (in the editor or browser). + +@item up +Goes one line up (in the editor or browser). + +@item down +Goes one line down (in the editor or browser). + +@item scrollup +Scrolls up one line of text from the current position. + +@item scrolldown +Scrolls down one line of text from the current position. + +@item nextword +Moves the cursor to the beginning of the next word. + +@item prevword +Moves the cursor to the beginning of the previous word. + +@item home +Moves the cursor to the beginning of the current line. + +@item end +Moves the cursor to the end of the current line. + +@item beginpara +Moves the cursor to the beginning of the current paragraph. + +@item endpara +Moves the cursor to the end of the current paragraph. + +@item prevpage +Goes up one screenful. + +@item nextpage +Goes down one screenful. + +@item firstline +Goes to the first line of the file. + +@item lastline +Goes to the last line of the file. + +@item gotoline +Goes to a specific line (and column if specified). + +@item findbracket +Moves the cursor to the bracket (brace, parenthesis, etc.) that matches +(pairs) with the one under the cursor. + +@item prevbuf +Switches to editing/viewing the previous buffer when using multibuffer mode. + +@item nextbuf +Switches to editing/viewing the next buffer when using multibuffer mode. + +@item verbatim +Inserts the next character verbatim into the file. + +@item tab +Inserts a tab at the current cursor location. + +@item enter +Inserts a new line below the current one. + +@item delete +Deletes the character under the cursor. + +@item backspace +Deletes the character before the cursor. + +@item undo +Undoes the last performed text action (add text, delete text, etc). + +@item redo +Redoes the last undone action (i.e., it undoes an undo). + +@item refresh +Refreshes the screen. + +@item suspend +Suspends the editor (if the suspending function is enabled, see the +"suspendenable" entry below). + +@item casesens +Toggles case sensitivity in searching (search/replace menus only). + +@item regexp +Toggles whether searching/replacing is based on literal strings or regular expressions. + +@item backwards +Toggles whether searching/replacing goes forward or backward. + +@item prevhistory +Shows the previous history entry in the prompt menus (e.g. search). + +@item nexthistory +Shows the next history entry in the prompt menus (e.g. search). + +@item dontreplace +Switches back to searching instead of replacing. + +@item gototext +Searches for files matching a string in the file browser (reading or writing files). + +@item dosformat +When writing a file, switches to writing a DOS format (CR/LF). + +@item macformat +When writing a file, switches to writing a Mac format. + +@item append +When writing a file, appends to the end instead of overwriting. + +@item prepend +When writing a file, 'prepends' (writes at the beginning) instead of overwriting. + +@item backup +When writing a file, creates a backup of the current file. + +@item firstfile +Goes to the first file when using the file browser (reading or writing files). + +@item lastfile +Goes to the last file when using the file browser (reading or writing files). + +@item nohelp +Toggles the presence of the two-line list of key bindings at the bottom of the screen. + +@item constupdate +Toggles the constant display of the current line, column, and character positions. + +@item morespace +Toggles the presence of the blank line which 'separates' the titlebar from the file text. + +@item smoothscroll +Toggles smooth scrolling (when moving around with the arrow keys). + +@item softwrap +Toggles the displaying of overlong lines on multiple screen lines. + +@item whitespacedisplay +Toggles the showing of whitespace. + +@item nosyntax +Toggles syntax highlighting. + +@item smarthome +Toggles the smartness of the Home key. + +@item autoindent +Toggles whether new lines will contain the same amount of whitespace as the preceding line. + +@item cuttoend +Toggles whether cutting text will cut the whole line or just from the current cursor +position to the end of the line. + +@item nowrap +Toggles whether long lines will be hard-wrapped to the next line. + +@item tabstospaces +Toggles whether typed tabs will be converted to spaces. + +@item backupfile +Toggles whether a backup will be made of the file to be edited. + +@item multibuffer +Toggles the use of multiple file buffers (if available). + +@item mouse +Toggles mouse support. + +@item noconvert +Toggles automatic conversion of files from DOS/Mac format. + +@item suspendenable +Toggles whether the suspend sequence (normally ^Z) will suspend the editor window. @end table +Valid names for @code{menu} are: + +@table @code + +@item main +The main editor window where text is entered and edited. + +@item search +The search menu (AKA whereis). + +@item replace +The 'search to replace' menu. + +@item replacewith +The 'replace with' menu, which comes up after 'search to replace'. + +@item gotoline +The 'goto line (and column)' menu. + +@item writeout +The 'write file' menu. + +@item insert +The 'insert file' menu. + +@item extcmd +The menu for inserting output from an external command, reached from the insert menu. + +@item help +The help-viewer menu. + +@item spell +The interactive spell checker Yes/no menu. + +@item linter +The linter menu. -@node The File Browser, Pico Compatibility, Nanorc Files, Top +@item browser +The file browser for inserting or writing a file. + +@item whereisfile +The 'search for a file' menu in the file browser. + +@item gotodir +The 'go to directory' menu in the file browser. + +@item all +A special name meaning: apply to all menus where this function exists. +@end table + + +@node The File Browser @chapter The File Browser When reading or writing files, pressing ^T will invoke the file browser. @@ -730,7 +1193,8 @@ enter and display the contents of the directory. If the object is a file, this filename and path are copied to the statusbar, and the file browser exits. -@node Pico Compatibility, Building and Configure Options, The File Browser, Top + +@node Pico Compatibility @chapter Pico Compatibility @code{nano} attempts to emulate Pico as closely as possible, but there @@ -766,14 +1230,14 @@ functions can be toggled for a particular version of @code{nano}. See @item Cursor Position Display The output of the "Display Cursor Position" in @code{nano} displays -the given column position, as well as the row and total character -position of the cursor. +the current line position of the cursor, as well as the column and +total character position. @item Interactive Replace and Spell Checker It is worth noting that @code{nano}'s replace function is interactive, -i.e. it does not stop after one search string is found and automatically -replace it. The @code{nano} implementation will pause at each search -string found and query whether to replace this instance or not. The +i.e. it does not stop after one search string was found and automatically +replaced. The @code{nano} implementation will pause at each found +search string and query whether to replace this instance or not. The internal spell checker operates similarly. Note that there is no way to force these functions to behave in the Pico fashion. As of version 1.1.99pre1, misspelled words are sorted and trimmed for uniqueness in @@ -781,7 +1245,8 @@ the internal spell checker such that the words 'apple' and 'Apple' will be prompted for correction separately. @end table -@node Building and Configure Options, , Pico Compatibility, Top + +@node Building and Configure Options @chapter Building and Configure Options Building @code{nano} from source is fairly straightforward if you are @@ -803,6 +1268,13 @@ The possible options to @code{./configure} are: @item --disable-browser Disable the mini file browser when reading or writing files. +@item --disable-color +Disable support for syntax coloring of files using the nanorc file. + +@item --disable-extra +Disable extra features. At the moment, this is just easter-egg-type +stuff. + @item --disable-help Disable the help function. Doing this makes the binary much smaller, but makes it difficult for new users to learn more than very basic @@ -811,73 +1283,69 @@ things about using the editor. @item --disable-justify Disable the justify and unjustify functions. +@item --disable-libmagic +Disable the use of the library of magic-number tests (for determining +the file type and thus which syntax to use for colouring -- often the +tests on filename extension and header line will be enough). + @item --disable-mouse -Disable all mouse functionality. This also disables the -m command line -option, which enables the mouse functionality. +Disable all mouse functionality. This also eliminates the -m +command-line option, which enables the mouse functionality. + +@item --disable-multibuffer +Disable support for opening multiple files at a time and switching +between them on the fly. + +@item --disable-nanorc +Disable support for reading the nanorc files at startup. With such +support, you can store custom settings in a system-wide and a per-user +nanorc file rather than having to pass command-line options to get +the desired behavior. See @xref{Nanorc Files}, for more info. @item --disable-operatingdir -Disable setting the operating directory. This also disables the -o -command line option, which sets the operating directory. +Disable setting the operating directory. This also eliminates the -o +command-line option, which sets the operating directory. @item --disable-speller -Disable use of the spell checker. This also disables the -s command -line option, which allows specifying an alternate spell checker. +Disable use of the spell checker. This also eliminates the -s +command-line option, which allows specifying an alternate spell checker. @item --disable-tabcomp Disable the tab completion code when reading or writing files. @item --disable-wrapping -Disable all long line wrapping. This also eliminates the -w command -line option, which enables long line wrapping. +Disable hard-wrapping of overlong lines. This also eliminates the -w +command-line option, which enables long-line wrapping. @item --enable-tiny This option disables all the above. It also disables some of the larger -internals of the editor, like the marking code and the cut to end of -line code. It also disables the function toggles. +internals of the editor, like the marking code and the cut-to-end-of-line +code. It also disables the function toggles. @item --enable-debug Enable support for runtime debug output. This can get pretty messy, so -chances are you only want this feature to work on the nano source. - -@item --enable-extra -Enable extra features. At the moment, this is just easter egg-type -stuff. - -@item --enable-color -Enable support for syntax coloring of files using the nanorc file. This -enables nanorc support as well. - -@item --enable-multibuffer -Enable support for opening multiple files at a time and switching -between them on the fly. - -@item --enable-nanorc -Enable support for reading the nanorc file at startup. You can store -custom settings in the nanorc file rather than having to pass command -line options to get desired behavior. See @xref{Nanorc Files}, for -more info. - -@item --enable-all -Shortcut for enabling the above four features (extra, color, -multibuffer, and nanorc). +chances are you only want this feature when you're working on the nano source. @item --disable-nls Disables Native Language support. This will disable use of the available GNU @code{nano} translations. @item --disable-wrapping-as-root -Disable long line wrapping by default when nano is run as root. +Disable hard-wrapping of overlong lines by default when @code{nano} +is run as root. @item --enable-utf8 Enable support for reading and writing Unicode files. This will require either a wide version of curses, or a UTF-8-enabled version of Slang. @item --disable-utf8 -Disable support for reading and writing Unicode files. +Disable support for reading and writing Unicode files. Normally the +configure script auto-detects whether to enable UTF-8 support or not. +You can use this or the previous option to override that detection. @item --with-slang -Compiling @code{nano} with Slang is supported, and will make the binary -notably smaller than if compiled with ncurses or other curses libraries. +Compile @code{nano} against Slang instead of against ncurses or other +curses libraries. @end table |