From fb040ea36cb8e2158ccd9100600652f94ae90af1 Mon Sep 17 00:00:00 2001 From: Lorry Tar Creator Date: Mon, 23 Mar 2015 03:49:03 +0000 Subject: Imported from /home/lorry/working-area/delta_nano-tarball/nano-2.4.0.tar.gz. --- doc/Makefile.am | 12 +- doc/Makefile.in | 356 ++++--- doc/faq.html | 110 +- doc/man/Makefile.am | 35 +- doc/man/Makefile.in | 445 ++++---- doc/man/fr/Makefile.am | 31 +- doc/man/fr/Makefile.in | 266 +++-- doc/man/fr/nano.1 | 254 ++--- doc/man/fr/nano.1.html | 474 +++++---- doc/man/fr/nanorc.5 | 328 +++--- doc/man/fr/nanorc.5.html | 589 ++++++----- doc/man/fr/rnano.1 | 114 +- doc/man/fr/rnano.1.html | 159 +-- doc/man/nano.1 | 224 ++-- doc/man/nano.1.html | 352 ++++--- doc/man/nanorc.5 | 603 ++++++----- doc/man/nanorc.5.html | 1035 ++++++++++-------- doc/man/rnano.1 | 42 +- doc/man/rnano.1.html | 61 +- doc/nanorc.sample.in | 173 +-- doc/syntax/Makefile.am | 35 +- doc/syntax/Makefile.in | 180 +++- doc/syntax/asm.nanorc | 14 +- doc/syntax/awk.nanorc | 28 +- doc/syntax/c.nanorc | 31 +- doc/syntax/changelog.nanorc | 25 + doc/syntax/cmake.nanorc | 4 +- doc/syntax/css.nanorc | 5 +- doc/syntax/debian.nanorc | 33 +- doc/syntax/default.nanorc | 10 + doc/syntax/fortran.nanorc | 32 +- doc/syntax/gentoo.nanorc | 56 +- doc/syntax/go.nanorc | 45 + doc/syntax/groff.nanorc | 21 +- doc/syntax/html.nanorc | 11 +- doc/syntax/java.nanorc | 7 +- doc/syntax/javascript.nanorc | 19 + doc/syntax/json.nanorc | 32 + doc/syntax/lua.nanorc | 62 ++ doc/syntax/makefile.nanorc | 6 +- doc/syntax/man.nanorc | 22 +- doc/syntax/mgp.nanorc | 5 +- doc/syntax/mutt.nanorc | 7 +- doc/syntax/nanorc.nanorc | 32 +- doc/syntax/objc.nanorc | 26 +- doc/syntax/ocaml.nanorc | 7 +- doc/syntax/patch.nanorc | 15 +- doc/syntax/perl.nanorc | 6 +- doc/syntax/php.nanorc | 25 +- doc/syntax/po.nanorc | 27 + doc/syntax/pov.nanorc | 6 +- doc/syntax/python.nanorc | 25 +- doc/syntax/ruby.nanorc | 36 +- doc/syntax/sh.nanorc | 25 +- doc/syntax/spec.nanorc | 39 + doc/syntax/tcl.nanorc | 10 +- doc/syntax/tex.nanorc | 3 +- doc/syntax/texinfo.nanorc | 20 + doc/syntax/xml.nanorc | 6 +- doc/texinfo/Makefile.in | 237 +++-- doc/texinfo/nano.html | 2322 +++++++++++++++++++++++++++++------------ doc/texinfo/nano.info | 1436 +++++++++++++++++-------- doc/texinfo/nano.texi | 1114 +++++++++++++++----- doc/texinfo/texinfo.tex | 2376 ++++++++++++++++++++++++++++-------------- 64 files changed, 9108 insertions(+), 5038 deletions(-) create mode 100644 doc/syntax/changelog.nanorc create mode 100644 doc/syntax/default.nanorc create mode 100644 doc/syntax/go.nanorc create mode 100644 doc/syntax/javascript.nanorc create mode 100644 doc/syntax/json.nanorc create mode 100644 doc/syntax/lua.nanorc create mode 100644 doc/syntax/po.nanorc create mode 100644 doc/syntax/spec.nanorc create mode 100644 doc/syntax/texinfo.nanorc (limited to 'doc') diff --git a/doc/Makefile.am b/doc/Makefile.am index 15f35ee..c197ceb 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 b30918f..d7461b4 100644 --- a/doc/Makefile.in +++ b/doc/Makefile.in @@ -1,9 +1,8 @@ -# Makefile.in generated by automake 1.11.1 from Makefile.am. +# Makefile.in generated by automake 1.14.1 from Makefile.am. # @configure_input@ -# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, -# 2003, 2004, 2005, 2006, 2007, 2008, 2009 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,7 +13,53 @@ # PARTICULAR PURPOSE. @SET_MAKE@ + VPATH = @srcdir@ +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 \ + *\\[\ \ ]*) \ + bs=\\; \ + sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \ + | sed "s/$$bs$$bs[$$bs $$bs ]*//g"`;; \ + esac; \ + 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@ @@ -33,12 +78,15 @@ PRE_UNINSTALL = : POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ -target_triplet = @target@ +@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 \ @@ -50,20 +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 @@ -95,6 +210,7 @@ am__relativize = \ reldir="$$dir2" ACLOCAL = @ACLOCAL@ AMTAR = @AMTAR@ +AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ @@ -140,6 +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@ @@ -151,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@ @@ -180,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@ @@ -204,17 +328,12 @@ sbindir = @sbindir@ sharedstatedir = @sharedstatedir@ srcdir = @srcdir@ sysconfdir = @sysconfdir@ -target = @target@ target_alias = @target_alias@ -target_cpu = @target_cpu@ -target_os = @target_os@ -target_vendor = @target_vendor@ 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: @@ -250,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; \ @@ -282,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 \ @@ -348,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; \ @@ -365,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 @@ -382,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 @@ -418,13 +522,10 @@ distdir: $(DISTFILES) done @list='$(DIST_SUBDIRS)'; for subdir in $$list; do \ if test "$$subdir" = .; then :; else \ - test -d "$(distdir)/$$subdir" \ - || $(MKDIR_P) "$(distdir)/$$subdir" \ - || exit 1; \ - fi; \ - done - @list='$(DIST_SUBDIRS)'; for subdir in $$list; do \ - if test "$$subdir" = .; then :; else \ + $(am__make_dryrun) \ + || test -d "$(distdir)/$$subdir" \ + || $(MKDIR_P) "$(distdir)/$$subdir" \ + || exit 1; \ dir1=$$subdir; dir2="$(distdir)/$$subdir"; \ $(am__relativize); \ new_distdir=$$reldir; \ @@ -446,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 @@ -459,10 +563,15 @@ install-am: all-am installcheck: installcheck-recursive install-strip: - $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ - install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ - `test -z '$(STRIP)' || \ - echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install + if test -z '$(STRIP)'; then \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + install; \ + else \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \ + fi mostlyclean-generic: clean-generic: @@ -494,7 +603,7 @@ info: info-recursive info-am: -install-data-am: +install-data-am: install-dist_htmlDATA install-dvi: install-dvi-recursive @@ -538,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 70baba5..d24a895 100644 --- a/doc/faq.html +++ b/doc/faq.html @@ -24,7 +24,6 @@

3.1. How do I install the RPM or DEB package?
3.2. Compiling from source: WHAT THE HECK DO I DO NOW?
3.3. Why does everything go into /usr/local?
- 3.4. I get errors about 'bindtextdomain','gettext', and/or 'gettextdomain'. What can I do about it?
3.5. nano should automatically run strip on the binary when installing it!
3.6. How can I make the executable smaller? This is too bloated!
3.7. Tell me more about this multibuffer stuff!
@@ -46,7 +45,8 @@ 4.11. How do I make nano my default editor (in Pine, mutt, etc.)?
4.12. I've compiled nano with color support, but I don't see any color when I run it!
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?
- 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?

+ 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?
+ 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!

5. Internationalization

5.1. There's no translation for my language!
5.2. I don't like the translation for <x> in my language. How can I fix it?
@@ -84,7 +84,7 @@

1.5. Why the name change from TIP?

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

1.6. What is the current version of nano?

-

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.

+

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.

1.7. I want to read the man page without having to download the program!

Jeez, demanding, aren't we? Okay, look here.

@@ -93,7 +93,6 @@

The nano distribution can be downloaded at the following fine web and ftp sites:

@@ -101,18 +100,17 @@

2.3. Debian (.deb) packages.

Debian users can check out the current nano packages for:

You can also have a look at the Package Pool to see all the available binary and source packages.

-

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.

+

2.4. By subversion (for the brave).

For the 'bleeding edge' current version of nano, you can use subversion to download the current source code. Note: 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 the nano SVN document for info on anonymous SVN access to the nano source.

@@ -121,10 +119,8 @@

It's simple really! As root, type rpm -Uvh nano-x.y.z-1.i386.rpm if you have a RedHat-ish system or dpkg -i nano_x.y.z-1.deb if you have a Debian-ish system, where x.y.z is the release of nano. There are other programs to install packages, and if you wish to use those, knock yourself out.

3.2. Compiling from source: WHAT THE HECK DO I DO NOW?

Okay, take a deep breath, this really isn't hard. Unpack the nano source with a command like:

-

tar -zxvf nano-x.y.z.tar.gz

-

If you get error messages about the -z option, try this:

-

gzip -dc nano-x.y.z.tar.gz | tar xvf -

-

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

+

tar -xvf nano-x.y.z.tar.gz

+

Then you need to run configure with any options you might want (if any).

The average case is this:

cd nano-x.y.z/
./configure
@@ -134,73 +130,67 @@

Well, that's what the configure script defaults to. If you wish to change this, simply do this:

./configure --prefix=/usr

to put nano into /usr/bin when you run make install.

-

3.4. I get errors about 'bindtextdomain', 'gettext', and/or 'gettextdomain'. What can I do about it?

-

Try doing a ./configure --with-included-gettext and see if that solves your problem. You may need to do a make clean; make to get it to work fully.

3.5. nano should automatically run strip on the binary when installing it!

Actually, it does, but you have to use make install-strip. The default make install does not, and will not, run strip automatically.

3.6. How can I make the executable smaller? This is too bloated!

Actually, there are several parts of the editor that can be disabled. You can pass arguments to the configure script that disable certain features. Here's a brief list:

-  --disable-tabcomp       Disable tab completion functions
-  --disable-justify       Disable justify/unjustify functions
-  --disable-speller       Disable spell checker functions
-  --disable-help          Disable help functions
   --disable-browser       Disable built-in file browser
-  --disable-wrapping      Disable all wrapping of text (and -w flag)
+  --disable-color         Disable color and syntax highlighting
+  --disable-extra         Disable extra features, currently only an easter egg
+  --disable-help          Disable help functions
+  --disable-justify       Disable justify/unjustify functions
   --disable-mouse         Disable mouse support (and -m flag)
-  --disable-operatingdir  Disable setting of operating directory
-

There's also the --enable-tiny 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 --disable-nls 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 strip to strip all debugging code and code that exists in libraries on your system.

-

If, on the other hand, you can't live without bells and whistles, you could try:

- 
-  --enable-extra          Enable extra features, currently only easter eggs
-  --enable-nanorc         Enable use of .nanorc files
-  --enable-color          Enable color and syntax highlighting
-  --enable-multibuffer    Enable having multiple file buffers open
-  --enable-all            Enable all of the above features
-  --disable-wrapping-as-root
-                          Disable text wrapping by default when the user is
-                          root
+ --disable-multibuffer Disable having multiple file buffers open + --disable-nanorc Disable the use of .nanorc files + --disable-operatingdir Disable setting of operating directory + --disable-speller Disable spell checker functions + --disable-tabcomp Disable tab completion functions + --disable-wrapping Disable all wrapping of text (and -w flag) +

There's also the --enable-tiny 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 --disable-nls 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 strip to strip all debugging code and code that exists in libraries on your system.

+

With --disable-wrapping-as-root you can disable any hard-wrapping by default when the user is root, useful to prevent accidentally changing long lines in system configuration files.

+

3.7. Tell me more about this multibuffer stuff!

-

To use multiple file buffers, you must be using nano 1.1.0 or newer, and you must have configured nano with --enable-multibuffer (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 Meta-F, then insert the file as normal with ^R. If you always want files to be loaded into their own buffers, use the --multibuffer or -F flag when you invoke nano.

+

To use multiple file buffers, you must be using nano 1.1.0 or newer, and you must not have configured it with --disable-multibuffer nor with --enable-tiny (use nano -V 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 Meta-F, then insert the file as normal with ^R. If you always want files to be loaded into their own buffers, use the --multibuffer or -F flag when you invoke nano.

You can move between the buffers you have open with the Meta-< and Meta-> keys, or more easily with Meta-, and Meta-. (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.

3.8. Tell me more about this verbatim input stuff!

-

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 Meta-V. (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.

-

Alternatively, if you've enabled Unicode support (see section 5.3), you can press Meta-V 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.

+

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 Meta-V (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.

+

Alternatively, if you've enabled Unicode support (see section 5.3), you can press Meta-V 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.

3.9. How do I make a .nanorc file that nano will read when I start it?

-

It's not hard at all! But, your version of nano must have been compiled with --enable-nanorc, and again must be version 1.1.12 or newer (use nano -V to check your version and compiled features). Then simply copy the nanorc.sample 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 set and the getopt_long flag for the feature, for example "set nowrap" or "set suspend".

+

It's not hard at all! But, your version of nano must not have been compiled with --disable-nanorc, and must be version 1.1.12 or newer (use nano -V to check your version and compiled features). Then simply copy the nanorc.sample 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 set and the getopt_long flag for the feature, for example "set nowrap" or "set suspend".

3.9. How about in Win32?

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

-

We're still working on documentatino for enabling synax highlighting on Win32; please bear with us

-

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.

+

We're still working on documentation for enabling synax highlighting on Win32; please bear with us.

+

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.

4. Running

4.1. How do I open a file with a name beginning with '+' from the command line?

-

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:

+

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:

To open '+filename.txt' starting on line 1: nano +filename.txt
To open '+filename.txt' starting on line 10: nano +10 +filename.txt
To open '+filename.txt' starting on line 1, column 20: nano +,20 +filename.txt
To open '+filename.txt' starting on line 10, column 20: nano +10,20 +filename.txt
- To open '+filename.txt' starting on line 1 and 'filename.txt' starting on line 10 (if nano has been compiled with multibuffer support): nano +1 +filename.txt +20 filename.txt

+ To open '+filename.txt' starting on line 1 and 'filename.txt' starting on line 40 (if nano has been compiled with multibuffer support): nano +1 +filename.txt +40 filename.txt

4.2. Ack! My Backspace/Delete/Enter/Meta/double bucky key doesn't seem to work! What can I do?

Try setting your $TERM variable to 'vt100'. nano doesn't yet support every term entry under the sun.

Bourne shell users (bash and sh): export TERM=vt100
C Shell users (tcsh and csh): setenv TERM vt100

4.3. Ack! My numeric keypad's keys don't work properly when NumLock is off! What can I do?

-

You can use the -K or --rebindkeypad options on the command line, or add the line set rebindkeypad to your .nanorc. However, nano's mouse support won't work properly if you do any of these things.

+

You can use the -K or --rebindkeypad option on the command line, or add the line set rebindkeypad to your .nanorc. However, nano's mouse support won't work properly if you do any of these things.

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?

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.

4.5. How do I type the F13-F16 keys shown in the help browser? My keyboard only has F1-F12!

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.

4.6. nano crashes when I type <insert keystroke here>!

-

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 nano-devel list or to nano@nano-editor.org.

+

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 nano-devel list or in the bug database on Savannah.

4.7. nano crashes when I resize my window. How can I fix that?

-

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

+

Older versions of nano had this problem, please upgrade to a newer version (at least 0.9.9, but 2.2.6 is recommended).

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?

It's a bug in glibc 2.2.3. You should upgrade to at least glibc 2.2.4.

4.9. [version 1.1.12 and earlier] Why does nano show ^\ in the shortcut list instead of ^J?

-

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 -p option to nano (or hit Meta-P) you will get the same shortcuts at the bottom as Pico.

+

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.

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?!

-

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

+

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.

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?

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 clone, and clones by default should be compatible.

4.11. How do I make nano my default editor (in Pine, mutt, etc.)?

@@ -208,7 +198,7 @@

export EDITOR=/usr/local/bin/nano

or, if you use tcsh, put this in your .cshrc file:

setenv EDITOR /usr/local/bin/nano

-

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.

+

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.

Then, on top of that, if you use Pine, you must go into setup (type S at the main menu), and then configure (type C). Hit Enter on the lines that say:

[ ] enable-alternate-editor-cmd
[ ] enable-alternate-editor-implicitly

@@ -217,19 +207,24 @@

my_hdr X-Composer: nano x.y.z

Again, replace x.y.z with the version of nano you use.

4.12. I've compiled nano with color support, but I don't see any color when I run it!

-

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 nanorc.sample that comes with the nano source or your nano package. See Section 3.9.

+

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 doc/syntax subdirectory of the nano source, which are normally installed to /usr/local/share/nano. To enable all of them, uncomment the line # include "/usr/local/share/nano/*.nanorc" in your nanorc. See also section 3.9.

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?

Try holding down the Shift key and selecting or pasting the text as you normally would.

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?

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.

+

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!

+

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:
+mv ~/.nano/search_history ~/.nano_history
+ln -sf ~/.nano_history ~/.nano/search_history
+

5. Internationalization

5.1. There's no translation for my language!

-

On June of 2001, GNU nano entered the Free Translation Project and since then, translations should be managed from there.

-

If there isn't a translation for your language, you could ask your language team to translate nano, or better still, join your team and do it yourself. Joining a team is easy. You just need to ask the TP coordinator to add you to your team, and send a translation disclaimer to the FSF (this is necessary as nano is an official GNU package, but it does not mean that you transfer the rights of your work to the FSF, it's just so the FSF can legally manage them).

-

In any case, translating nano is very easy. Just grab the nano.pot file from the latest and greatest nano distribution (it's in the po/ directory) and translate each line into your native language on the msgstr line. When you're done, you should send it to the TP's central po repository.

+

On June of 2001, GNU nano entered the Translation Project and since then, translations should be managed from there.

+

If there isn't a translation for your language, you could ask your language team 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 translation disclaimer to the FSF (this is necessary as nano is an official GNU package, but it does not mean that you transfer the rights of your work to the FSF, it's just so the FSF can legally manage them).

+

In any case, translating nano is very easy. Just grab the latest nano.pot file listed on nano's page at the TP, and translate each msgid line into your native language on the msgstr line. When you're done, you should send it to the TP's central po repository.

5.2. I don't like the translation for <x> in my language. How can I fix it?

-

The best way would probably be to e-mail the person listed in the Last-Translator: field in the <your_language>.po file with your suggested corrections and they can make the changes reach the nano-devel list.

+

The best way would probably be to send an e-mail to the team's mailing listed mentione in the Language-Team: field in the <your_language>.po file with your suggested corrections, and then they can make the changes reach the nano-devel list.

5.3. What is the status of Unicode support?

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.

@@ -246,22 +241,23 @@ Of course, due to the license change you can now use the

7. Miscellaneous

7.1. nano-related mailing lists.

-

There are three mailing lists for nano hosted at Savannah, 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:

+

There are three mailing lists for nano hosted at Savannah: 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:

info-nano - http://mail.gnu.org/mailman/listinfo/info-nano/
help-nano - http://mail.gnu.org/mailman/listinfo/help-nano/
nano-devel - http://mail.gnu.org/mailman/listinfo/nano-devel/

7.2. I want to send the development team a big load of cash (or just a thank you).

-

That's fine. Send it our way! Better yet, fix a bug in the program or implement a cool feature and send us that instead (though cash is fine too).

+

That's fine. Send it our way! Better yet, fix a bug in the program or implement a cool feature and send us that instead (though cash is fine too).

7.3. How do I submit a bug report or patch?

-

The best place to submit bugs is to the Savannah bug tracker as you can check whether the bug you are submitting has already been submitted. +

The best place to submit bugs is to the Savannah bug tracker as you can check whether the bug you are submitting has already been submitted.

Please submit patches for nano via the Savannah project's patch manager for the nano project.

7.4. How do I join the development team?

-

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.

+

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.

7.5. Can I have write access to the subversion tree?

Re-read Section 7.4 and you should know the answer.

8. ChangeLog

-

2009/11/30 - Update various bits for nano 2.2.x. (DLR)
+

2014/04/24 - A bunch of small fixes and updates. (Benno)
+2009/11/30 - Update various bits for nano 2.2.x. (DLR)
2009/11/18 - Typo fix. (j.mader@gmail.com)
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)
2007/12/21 - Update maintainer information. (DLR)
@@ -326,6 +322,6 @@ Of course, due to the license change you can now use the &2; \ + exit 1;; \ + esac; \ + has_opt=no; \ + sane_makeflags=$$MAKEFLAGS; \ + if $(am__is_gnu_make); then \ + sane_makeflags=$$MFLAGS; \ + else \ + case $$MAKEFLAGS in \ + *\\[\ \ ]*) \ + bs=\\; \ + sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \ + | sed "s/$$bs$$bs[$$bs $$bs ]*//g"`;; \ + esac; \ + 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@ @@ -34,11 +78,17 @@ PRE_UNINSTALL = : POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ -target_triplet = @target@ +@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 \ @@ -50,15 +100,33 @@ 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;; \ + *) (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/||"`;; \ @@ -80,18 +148,45 @@ am__nobase_list = $(am__nobase_strip_setup); \ 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; }; \ + } 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 @@ -123,6 +218,7 @@ am__relativize = \ reldir="$$dir2" ACLOCAL = @ACLOCAL@ AMTAR = @AMTAR@ +AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ @@ -168,6 +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@ @@ -179,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@ @@ -208,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@ @@ -232,26 +336,16 @@ sbindir = @sbindir@ sharedstatedir = @sharedstatedir@ srcdir = @srcdir@ sysconfdir = @sysconfdir@ -target = @target@ target_alias = @target_alias@ -target_cpu = @target_cpu@ -target_os = @target_os@ -target_vendor = @target_vendor@ 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 @@ -286,13 +380,20 @@ $(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) - test -z "$(man1dir)" || $(MKDIR_P) "$(DESTDIR)$(man1dir)" - @list=''; test -n "$(man1dir)" || exit 0; \ - { for i in $$list; do echo "$$i"; done; \ - l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ - sed -n '/\.1[a-z]*$$/p'; \ + @list1=''; \ + list2='$(dist_man_MANS)'; \ + test -n "$(man1dir)" \ + && test -n "`echo $$list1$$list2`" \ + || exit 0; \ + echo " $(MKDIR_P) '$(DESTDIR)$(man1dir)'"; \ + $(MKDIR_P) "$(DESTDIR)$(man1dir)" || exit 1; \ + { for i in $$list1; do echo "$$i"; done; \ + if test -n "$$list2"; then \ + for i in $$list2; do echo "$$i"; done \ + | sed -n '/\.1[a-z]*$$/p'; \ + fi; \ } | while read p; do \ if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ echo "$$d$$p"; echo "$$p"; \ @@ -317,20 +418,25 @@ 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,.,'`; \ - test -z "$$files" || { \ - echo " ( cd '$(DESTDIR)$(man1dir)' && rm -f" $$files ")"; \ - cd "$(DESTDIR)$(man1dir)" && rm -f $$files; } -install-man5: $(man_MANS) + dir='$(DESTDIR)$(man1dir)'; $(am__uninstall_files_from_dir) +install-man5: $(dist_man_MANS) @$(NORMAL_INSTALL) - test -z "$(man5dir)" || $(MKDIR_P) "$(DESTDIR)$(man5dir)" - @list=''; test -n "$(man5dir)" || exit 0; \ - { for i in $$list; do echo "$$i"; done; \ - l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ - sed -n '/\.5[a-z]*$$/p'; \ + @list1=''; \ + list2='$(dist_man_MANS)'; \ + test -n "$(man5dir)" \ + && test -n "`echo $$list1$$list2`" \ + || exit 0; \ + echo " $(MKDIR_P) '$(DESTDIR)$(man5dir)'"; \ + $(MKDIR_P) "$(DESTDIR)$(man5dir)" || exit 1; \ + { for i in $$list1; do echo "$$i"; done; \ + if test -n "$$list2"; then \ + for i in $$list2; do echo "$$i"; done \ + | sed -n '/\.5[a-z]*$$/p'; \ + fi; \ } | while read p; do \ if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ echo "$$d$$p"; echo "$$p"; \ @@ -355,51 +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,.,'`; \ - test -z "$$files" || { \ - echo " ( cd '$(DESTDIR)$(man5dir)' && rm -f" $$files ")"; \ - cd "$(DESTDIR)$(man5dir)" && rm -f $$files; } -install-htmlmanDATA: $(htmlman_DATA) + dir='$(DESTDIR)$(man5dir)'; $(am__uninstall_files_from_dir) +install-dist_htmlDATA: $(dist_html_DATA) @$(NORMAL_INSTALL) - test -z "$(htmlmandir)" || $(MKDIR_P) "$(DESTDIR)$(htmlmandir)" - @list='$(htmlman_DATA)'; test -n "$(htmlmandir)" || list=; \ + @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)$(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|^.*/||'`; \ - test -n "$$files" || exit 0; \ - echo " ( cd '$(DESTDIR)$(htmlmandir)' && rm -f" $$files ")"; \ - cd "$(DESTDIR)$(htmlmandir)" && rm -f $$files + 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; \ @@ -414,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 \ @@ -480,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; \ @@ -497,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 @@ -514,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)'; \ @@ -563,13 +619,10 @@ distdir: $(DISTFILES) done @list='$(DIST_SUBDIRS)'; for subdir in $$list; do \ if test "$$subdir" = .; then :; else \ - test -d "$(distdir)/$$subdir" \ - || $(MKDIR_P) "$(distdir)/$$subdir" \ - || exit 1; \ - fi; \ - done - @list='$(DIST_SUBDIRS)'; for subdir in $$list; do \ - if test "$$subdir" = .; then :; else \ + $(am__make_dryrun) \ + || test -d "$(distdir)/$$subdir" \ + || $(MKDIR_P) "$(distdir)/$$subdir" \ + || exit 1; \ dir1=$$subdir; dir2="$(distdir)/$$subdir"; \ $(am__relativize); \ new_distdir=$$reldir; \ @@ -595,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) @@ -609,10 +662,15 @@ install-am: all-am installcheck: installcheck-recursive install-strip: - $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ - install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ - `test -z '$(STRIP)' || \ - echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install + if test -z '$(STRIP)'; then \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + install; \ + else \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \ + fi mostlyclean-generic: clean-generic: @@ -645,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 @@ -689,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 7a43052..d8c2d18 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 79d5987..3e3e3ac 100644 --- a/doc/man/fr/Makefile.in +++ b/doc/man/fr/Makefile.in @@ -1,9 +1,8 @@ -# Makefile.in generated by automake 1.11.1 from Makefile.am. +# Makefile.in generated by automake 1.14.1 from Makefile.am. # @configure_input@ -# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, -# 2003, 2004, 2005, 2006, 2007, 2008, 2009 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,6 +15,51 @@ @SET_MAKE@ VPATH = @srcdir@ +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 \ + *\\[\ \ ]*) \ + bs=\\; \ + sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \ + | sed "s/$$bs$$bs[$$bs $$bs ]*//g"`;; \ + esac; \ + 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@ @@ -34,11 +78,16 @@ PRE_UNINSTALL = : POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ -target_triplet = @target@ +@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 \ @@ -50,8 +99,25 @@ 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 = \ + 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/||"`;; \ @@ -73,16 +139,25 @@ am__nobase_list = $(am__nobase_strip_setup); \ 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; }; \ + } 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@ @@ -128,6 +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@ @@ -139,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@ @@ -168,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@ @@ -192,24 +275,15 @@ sbindir = @sbindir@ sharedstatedir = @sharedstatedir@ srcdir = @srcdir@ sysconfdir = @sysconfdir@ -target = @target@ target_alias = @target_alias@ -target_cpu = @target_cpu@ -target_os = @target_os@ -target_vendor = @target_vendor@ 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 @@ -244,13 +318,20 @@ $(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) - test -z "$(man1dir)" || $(MKDIR_P) "$(DESTDIR)$(man1dir)" - @list=''; test -n "$(man1dir)" || exit 0; \ - { for i in $$list; do echo "$$i"; done; \ - l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ - sed -n '/\.1[a-z]*$$/p'; \ + @list1=''; \ + list2='$(dist_man_MANS)'; \ + test -n "$(man1dir)" \ + && test -n "`echo $$list1$$list2`" \ + || exit 0; \ + echo " $(MKDIR_P) '$(DESTDIR)$(man1dir)'"; \ + $(MKDIR_P) "$(DESTDIR)$(man1dir)" || exit 1; \ + { for i in $$list1; do echo "$$i"; done; \ + if test -n "$$list2"; then \ + for i in $$list2; do echo "$$i"; done \ + | sed -n '/\.1[a-z]*$$/p'; \ + fi; \ } | while read p; do \ if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ echo "$$d$$p"; echo "$$p"; \ @@ -275,20 +356,25 @@ 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,.,'`; \ - test -z "$$files" || { \ - echo " ( cd '$(DESTDIR)$(man1dir)' && rm -f" $$files ")"; \ - cd "$(DESTDIR)$(man1dir)" && rm -f $$files; } -install-man5: $(man_MANS) + dir='$(DESTDIR)$(man1dir)'; $(am__uninstall_files_from_dir) +install-man5: $(dist_man_MANS) @$(NORMAL_INSTALL) - test -z "$(man5dir)" || $(MKDIR_P) "$(DESTDIR)$(man5dir)" - @list=''; test -n "$(man5dir)" || exit 0; \ - { for i in $$list; do echo "$$i"; done; \ - l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ - sed -n '/\.5[a-z]*$$/p'; \ + @list1=''; \ + list2='$(dist_man_MANS)'; \ + test -n "$(man5dir)" \ + && test -n "`echo $$list1$$list2`" \ + || exit 0; \ + echo " $(MKDIR_P) '$(DESTDIR)$(man5dir)'"; \ + $(MKDIR_P) "$(DESTDIR)$(man5dir)" || exit 1; \ + { for i in $$list1; do echo "$$i"; done; \ + if test -n "$$list2"; then \ + for i in $$list2; do echo "$$i"; done \ + | sed -n '/\.5[a-z]*$$/p'; \ + fi; \ } | while read p; do \ if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ echo "$$d$$p"; echo "$$p"; \ @@ -313,54 +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,.,'`; \ - test -z "$$files" || { \ - echo " ( cd '$(DESTDIR)$(man5dir)' && rm -f" $$files ")"; \ - cd "$(DESTDIR)$(man5dir)" && rm -f $$files; } -install-htmlmanDATA: $(htmlman_DATA) + dir='$(DESTDIR)$(man5dir)'; $(am__uninstall_files_from_dir) +install-dist_htmlDATA: $(dist_html_DATA) @$(NORMAL_INSTALL) - test -z "$(htmlmandir)" || $(MKDIR_P) "$(DESTDIR)$(htmlmandir)" - @list='$(htmlman_DATA)'; test -n "$(htmlmandir)" || list=; \ + @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)$(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|^.*/||'`; \ - test -n "$$files" || exit 0; \ - echo " ( cd '$(DESTDIR)$(htmlmandir)' && rm -f" $$files ")"; \ - cd "$(DESTDIR)$(htmlmandir)" && rm -f $$files -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)'; \ @@ -395,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) @@ -409,10 +481,15 @@ install-am: all-am installcheck: installcheck-am install-strip: - $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ - install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ - `test -z '$(STRIP)' || \ - echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install + if test -z '$(STRIP)'; then \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + install; \ + else \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \ + fi mostlyclean-generic: clean-generic: @@ -445,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 @@ -489,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 b/doc/man/fr/nano.1 index f840374..fdfb3cd 100644 --- a/doc/man/fr/nano.1 +++ b/doc/man/fr/nano.1 @@ -2,14 +2,14 @@ .\" Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007 .\" Free Software Foundation, Inc. .\" -.\" Le travail d'adaptation française de cette page de manuel a été -.\" réalisé par Jean-Philippe Guérard, en 2003, 2004, 2005, 2006 et 2007. +.\" Le travail d'adaptation française de cette page de manuel a été +.\" réalisé par Jean-Philippe Guérard, en 2003, 2004, 2005, 2006 et 2007. .\" Ce travail d'adaptation est dans le domaine public. Attention, la .\" page traduite reste soumise au droit d'auteur de ses auteurs .\" originaux. .\" .\" The French translation of this document is a public domain work of -.\" Jean-Philippe Guérard. This translation work was made in 2003, 2004, +.\" Jean-Philippe Guérard. This translation work was made in 2003, 2004, .\" 2005, 2006 and 2007. The translated man page in itself is still .\" subject to the copyright of its original authors. .\" @@ -29,92 +29,92 @@ .\" Documentation License along with this program. If not, see .\" . .\" -.\" Ce document est publié sous une double licence. Vous pouvez +.\" Ce document est publié sous une double licence. Vous pouvez .\" le distribuer et le modifier selon les termes de l'une des deux -.\" licences ci-dessous : +.\" licences ci-dessous : .\" -.\" * La Licence publique générale GNU (GNU GPL) version 3 ou, à -.\" votre choix, supérieure, telle que publiée par la Free -.\" Software Foundation. Vous devriez avoir reçu une copie de la -.\" Licence publique générale GNU avec ce programme. Si ce n'est pas +.\" * La Licence publique générale GNU (GNU GPL) version 3 ou, à +.\" votre choix, supérieure, telle que publiée par la Free +.\" Software Foundation. Vous devriez avoir reçu une copie de la +.\" Licence publique générale GNU avec ce programme. Si ce n'est pas .\" le cas, consultez . .\" .\" * La Licence de documentation libre GNU (GNU FDL), version 1.2 ou, -.\" à votre choix, supérieure, telle que publiée par la Free +.\" à votre choix, supérieure, telle que publiée par la Free .\" Software Foundation, sans section invariante, ni texte de -.\" première ou de quatrième de couverture. Vous devriez avoir reçu +.\" première ou de quatrième de couverture. Vous devriez avoir reçu .\" une copie de la Licence de documentation libre GNU avec ce .\" programme. Si ce n'est pas le cas, consultez .\" . .\" -.\" $Id: nano.1 4443 2009-11-27 02:50:12Z astyanax $ +.\" $Id: nano.1 5071 2014-07-16 17:25:55Z jordi $ .TH NANO 1 "version 2.0.0" "29\ novembre\ 2007" .\" Please adjust this date whenever revising the manpage. -.\" Merci de modifier ces dates à chaque mise à jour de cette page. +.\" Merci de modifier ces dates à chaque mise à jour de cette page. .\" .SH NOM -nano \- NAno un NOuvel éditeur, un clone libre et amélioré de Pico +nano \- NAno un NOuvel éditeur, un clone libre et amélioré de Pico .SH SYNOPSIS .B nano -.I [OPTIONS]\ [[\+LIGNE,COLONNE]\ FICHIER]... +.I [OPTIONS]\ [[+LIGNE,COLONNE]\ FICHIER]... .br .SH DESCRIPTION -Cette page de manuel décrit brièvement la commande \fBnano\fR. +Cette page de manuel décrit brièvement la commande \fBnano\fR. .PP .\" TeX users may be more comfortable with the \fB\fP and .\" \fI\fP escape sequences to invoke bold face and italics, .\" respectively. -\fBnano\fR est un éditeur petit, sympathique et libre, qui vise à remplacer -Pico, l'éditeur par défaut du logiciel non libre Pine. \fBnano\fR ne se +\fBnano\fR est un éditeur petit, sympathique et libre, qui vise à remplacer +Pico, l'éditeur par défaut du logiciel non libre Pine. \fBnano\fR ne se contentant pas de copier l'interface et l'ergonomie de Pico, il offre -également certaines fonctions manquantes (ou désactivées par défaut) -dans Pico. Ces fonctionnalités sont, par exemple, les fonctions de -recherche et de remplacement, et la possibilité de sauter directement à -une ligne et à une colonne précise. +également certaines fonctions manquantes (ou désactivées par défaut) +dans Pico. Ces fonctionnalités sont, par exemple, les fonctions de +recherche et de remplacement, et la possibilité de sauter directement à +une ligne et à une colonne précise. .SH OPTIONS .TP -.B \+\fILIGNE\fP,\fICOLONNE\fP -Démarre avec le curseur positionné à la colonne \fICOLONNE\fP de -la ligne \fILIGNE\fR (l'un des deux, au moins, devant être spécifié) au -lieu de démarrer à la colonne\ 1, ligne\ 1. +.B +\fILIGNE\fP,\fICOLONNE\fP +Démarre avec le curseur positionné à la colonne \fICOLONNE\fP de +la ligne \fILIGNE\fR (l'un des deux, au moins, devant être spécifié) au +lieu de démarrer à la colonne\ 1, ligne\ 1. .TP .B \-? -Identique à \fB-h (\-\-help)\fP. +Identique à \fB\-h (\-\-help)\fP. .TP .B \-A (\-\-smarthome) -Rend plus malin le fonctionnement de la touche «\ Début\ ». Lorsque l'on -appuie sur cette touche à n'importe quel endroit excepté au tout début -du texte d'une ligne (i.\ e. au premier caractère non blanc), le curseur -se positionnera au début du texte de la ligne (qu'il soit en avant ou en -arrière). Si le curseur est déjà là, il se placera au vrai début de la +Rend plus malin le fonctionnement de la touche «\ Début\ ». Lorsque l'on +appuie sur cette touche à n'importe quel endroit excepté au tout début +du texte d'une ligne (i.\ e. au premier caractère non blanc), le curseur +se positionnera au début du texte de la ligne (qu'il soit en avant ou en +arrière). Si le curseur est déjà là, il se placera au vrai début de la ligne. .TP .B \-B (\-\-backup) -Lors de l'écriture d'un fichier, crée une copie de sécurité de la -version précédente, en ajoutant un tilde (~) au nom du fichier. +Lors de l'écriture d'un fichier, crée une copie de sécurité de la +version précédente, en ajoutant un tilde (~) au nom du fichier. .TP .B \-D (\-\-boldtext) -Utilise des caractères gras à la place de la vidéo inverse. +Utilise des caractères gras à la place de la vidéo inverse. .TP -.B \-C \fIrépertoire\fP (\-\-backupdir=\fIrépertoire\fP) -Définit le répertoire utilisé par \fBnano\fP pour enregistrer les copies -de sécurité uniques si celles-ci sont activées. +.B \-C \fIrépertoire\fP (\-\-backupdir=\fIrépertoire\fP) +Définit le répertoire utilisé par \fBnano\fP pour enregistrer les copies +de sécurité uniques si celles-ci sont activées. .TP .B \-E (\-\-tabstospaces) Convertit les tabulations clavier en espaces. .TP .B \-F (\-\-multibuffer) -Active le mode multi-espace, autorisant l'édition simultanée de +Active le mode multi-espace, autorisant l'édition simultanée de plusieurs fichiers, si ce mode est disponible. .TP .B \-H (\-\-historylog) -Enregistre les chaînes ayant fait l'objet d'une recherche ou d'un +Enregistre les chaînes ayant fait l'objet d'une recherche ou d'un remplacement dans le fichier \fI~/.nano_history\fR afin de permettre leur -réutilisation. Ceci n'est possible que si \fBnano\fR est configuré pour +réutilisation. Ceci n'est possible que si \fBnano\fR est configuré pour utiliser les fichiers nanorc. .TP .B \-I (\-\-ignorercfiles) @@ -122,63 +122,63 @@ Ne pas utiliser pas les fichiers \fISYSCONFDIR/nanorc\fR et \fI~/.nanorc\fR (si \fBnano\fR est capable de les utiliser). .TP .B \-K (\-\-rebindkeypad) -Interprète les touches du pavé numérique afin qu'elles fonctionnent +Interprète les touches du pavé numérique afin qu'elles fonctionnent toutes correctement. Vous ne devriez utiliser cette option que si ce n'est pas le cas, car nano ne sera plus capable d'utiliser la souris -correctement lorsque cette option sera activée. +correctement lorsque cette option sera activée. .TP .B \-L (\-\-nonewlines) -Ne pas ajouter de passage à la ligne à la fin des fichiers. +Ne pas ajouter de passage à la ligne à la fin des fichiers. .TP .B \-N (\-\-noconvert) -Désactive la conversion automatique des fichiers depuis les formats Mac et +Désactive la conversion automatique des fichiers depuis les formats Mac et DOS. .TP .B \-O (\-\-morespace) -Utiliser la ligne blanche située sous la ligne de titre comme -espace supplémentaire d'édition. +Utiliser la ligne blanche située sous la ligne de titre comme +espace supplémentaire d'édition. .TP -.B \-Q \fIchaîne\fP (\-\-quotestr=\fIchaîne\fP) -Définit le préfixe par défaut des citations. Nano utilise ce préfixe -pour réaliser une justification correcte des citations. Si nano est -capable d'utiliser des expressions rationnelles, le préfixe par défaut +.B \-Q \fIchaîne\fP (\-\-quotestr=\fIchaîne\fP) +Définit le préfixe par défaut des citations. Nano utilise ce préfixe +pour réaliser une justification correcte des citations. Si nano est +capable d'utiliser des expressions rationnelles, le préfixe par défaut sera "\fI^([\ \\t]*[#:>\\|}])+\fP", sinon, ce sera "\fI>\ \fP". Dans -l'expression rationnelle précédente, «\ \fI\\t\fP\ » représente une +l'expression rationnelle précédente, «\ \fI\\t\fP\ » représente une tabulation. .TP .B \-R (\-\-restricted) -Mode restreint\ : aucune lecture ou écriture de fichiers non indiqués +Mode restreint\ : aucune lecture ou écriture de fichiers non indiqués sur la ligne de commande, pas de lecture des fichiers nanorc, -interdiction de suspendre, interdiction d'ajouter au début, à la fin, -de sauvegarder un fichier ayant déjà un nom sous un nom différent, -d'utiliser une copie de sécurité ou le correcteur orthographique. Cette -option peut aussi être activée en appelant \fBnano\fP sous un nom -commençant par «\ r\ » (par exemple «\ rnano\ »). +interdiction de suspendre, interdiction d'ajouter au début, à la fin, +de sauvegarder un fichier ayant déjà un nom sous un nom différent, +d'utiliser une copie de sécurité ou le correcteur orthographique. Cette +option peut aussi être activée en appelant \fBnano\fP sous un nom +commençant par «\ r\ » (par exemple «\ rnano\ »). .TP .B \-S (\-\-smooth) -Active le défilement progressif. Le texte défilera ligne-par-ligne au lieu -de défiler morceau-par-morceau. +Active le défilement progressif. Le texte défilera ligne-par-ligne au lieu +de défiler morceau-par-morceau. .TP .B \-T \fInombre\fP (\-\-tabsize=\fInombre\fP) -Définit la taille (largeur) des tabulations en nombre de colonnes. Le -nombre indiqué doit être strictement supérieur à 0. La valeur par défaut +Définit la taille (largeur) des tabulations en nombre de colonnes. Le +nombre indiqué doit être strictement supérieur à 0. La valeur par défaut est de 8. .TP .B \-U (\-\-quickblank) -Effacement rapide de la ligne d'état. Les messages affichés par la ligne -d'état disparaîtront après une frappe clavier au lieu de 25. Notez que +Effacement rapide de la ligne d'état. Les messages affichés par la ligne +d'état disparaîtront après une frappe clavier au lieu de 25. Notez que l'option \fB-c\fP prend le pas sur cette option. .TP .B \-V (\-\-version) -Affiche la version, puis s'arrête. +Affiche la version, puis s'arrête. .TP .B \-W (\-\-wordbounds) -Détection plus précise des limites de mots, obtenue en considérant les -caractères de ponctuation comme faisant partie des mots. +Détection plus précise des limites de mots, obtenue en considérant les +caractères de ponctuation comme faisant partie des mots. .TP -.B \-Y \fIchaîne\fP (\-\-syntax=\fIchaîne\fP) +.B \-Y \fIchaîne\fP (\-\-syntax=\fIchaîne\fP) Indique quel mode de colorisation syntaxique adopter, parmi les modes -définis dans le fichier \fI.nanorc\fR, si cette fonctionnalité est +définis dans le fichier \fI.nanorc\fR, si cette fonctionnalité est disponible. .TP .B \-c (\-\-const) @@ -186,111 +186,111 @@ Affiche en permanence la position du curseur. Notez que cette option prend le pas sur l'option \fB-U\fP. .TP .B \-d (\-\-rebinddelete) -Interprète différemment la touche «\ Supprimer\ », afin que les touches -«\ Effacement arrière\ » et «\ Supprimer\ » fonctionnent correctement. -Vous ne devriez avoir besoin de cette option que si, sur votre système, -la touche «\ Effacement arrière\ » produit l'effet de la touche -«\ Supprimer\ ». +Interprète différemment la touche «\ Supprimer\ », afin que les touches +«\ Effacement arrière\ » et «\ Supprimer\ » fonctionnent correctement. +Vous ne devriez avoir besoin de cette option que si, sur votre système, +la touche «\ Effacement arrière\ » produit l'effet de la touche +«\ Supprimer\ ». .TP .B \-h (\-\-help) -Affiche un résumé des options de lancement de nano, puis s'arrête. +Affiche un résumé des options de lancement de nano, puis s'arrête. .TP .B \-i (\-\-autoindent) -Indentation automatique. Commence chaque nouvelle ligne au même niveau que -la ligne précédente. Utile pour l'édition de code source. +Indentation automatique. Commence chaque nouvelle ligne au même niveau que +la ligne précédente. Utile pour l'édition de code source. .TP .B \-k (\-\-cut) -Coupe le texte du curseur à la fin de la ligne, au lieu de couper la -ligne entière. +Coupe le texte du curseur à la fin de la ligne, au lieu de couper la +ligne entière. .TP .B \-l (\-\-nofollow) -Si le fichier édité est un lien symbolique, au lieu de le suivre, -remplace le lien par le nouveau fichier. Sans doute utile pour éditer +Si le fichier édité est un lien symbolique, au lieu de le suivre, +remplace le lien par le nouveau fichier. Sans doute utile pour éditer les fichiers de \fI/tmp\fR, non\ ? .TP .B \-m (\-\-mouse) Active l'utilisation de la souris, si elle est disponible pour votre -système. Lorsque celle-ci est activée, il est possible d'utiliser la +système. Lorsque celle-ci est activée, il est possible d'utiliser la souris pour positionner le curseur, pour marquer le texte (avec un double-clic) et pour lancer les fonctions correspondant aux raccourcis. Il est possible d'utiliser la souris sous X\ Window ou en mode console avec gpm. .TP -.B \-o \fIrépertoire\fP (\-\-operatingdir=\fIrépertoire\fP) -Définit le répertoire de travail. Demande à \fBnano\fP de mettre en place -quelque chose de similaire à un environnement d'exécution restreint +.B \-o \fIrépertoire\fP (\-\-operatingdir=\fIrépertoire\fP) +Définit le répertoire de travail. Demande à \fBnano\fP de mettre en place +quelque chose de similaire à un environnement d'exécution restreint (\fIchroot\fR). .TP .B \-p (\-\-preserve) -Préserve les séquences XON et XOFF (^Q et ^S), afin qu'elle soient reçues +Préserve les séquences XON et XOFF (^Q et ^S), afin qu'elle soient reçues par le terminal. .TP .B \-r \fIcolonne\fP (\-\-fill=\fIcolonne\fP) -Passe automatiquement à la ligne une fois arrivé à la colonne -\fIcolonne\fR. Si la valeur indiquée est de 0 ou moins, le point de -passage à la ligne aura lieu à la taille de l'écran moins \fIcolonne\fR. -Cela permet de faire varier le point de passage à la ligne lorsque l'on -change la taille de l'écran. La valeur par défaut est de \-8. +Passe automatiquement à la ligne une fois arrivé à la colonne +\fIcolonne\fR. Si la valeur indiquée est de 0 ou moins, le point de +passage à la ligne aura lieu à la taille de l'écran moins \fIcolonne\fR. +Cela permet de faire varier le point de passage à la ligne lorsque l'on +change la taille de l'écran. La valeur par défaut est de \-8. .TP .B \-s \fIprogramme\fP (\-\-speller=\fIprogramme\fP) Choix d'un correcteur orthographique de remplacement. .TP .B \-t (\-\-tempfile) -S'il a été modifié, le fichier sera sauvegardé automatiquement sans -demande de confirmation. Identique à l'option \fB-t\fP de Pico. +S'il a été modifié, le fichier sera sauvegardé automatiquement sans +demande de confirmation. Identique à l'option \fB-t\fP de Pico. .TP .B \-v (\-\-view) Mode visualisation (lecture seule). .TP .B \-w (\-\-nowrap) -Désactive le passage automatique à la ligne. +Désactive le passage automatique à la ligne. .TP .B \-x (\-\-nohelp) -Désactive la barre d'aide affichée en bas de l'écran. +Désactive la barre d'aide affichée en bas de l'écran. .TP .B \-z (\-\-suspend) -Autorise à suspendre l'éditeur. +Autorise à suspendre l'éditeur. .TP .B \-a, \-b, \-e, \-f, \-g, \-j -Ignoré, pour être compatible avec Pico. +Ignoré, pour être compatible avec Pico. .SH "FICHIERS D'INITIALISATION" \fBnano\fR lit les fichiers d'initialisation dans l'ordre suivant\ : -\fISYSCONFDIR/nanorc\fR, puis \fI~/.nanorc\fR. Référez-vous à la page de +\fISYSCONFDIR/nanorc\fR, puis \fI~/.nanorc\fR. Référez-vous à la page de manuel de \fBnanorc(5)\fR et au fichier d'exemple \fInanorc.sample\fR, -qui devraient tous les deux être livrés avec \fBnano\fR. +qui devraient tous les deux être livrés avec \fBnano\fR. .SH NOTES -Si aucun correcteur orthographique de remplacement n'est indiqué dans la +Si aucun correcteur orthographique de remplacement n'est indiqué dans la ligne de commande ou dans l'un des fichiers nanorc, \fBnano\fR prendra -la commande indiquée par la variable d'environnement \fBSPELL\fR si -elle est définie. +la commande indiquée par la variable d'environnement \fBSPELL\fR si +elle est définie. Dans certains cas, \fBnano\fR essaiera de sauvegarder le fichier en cours -d'édition dans un fichier de secours. Cela arrivera principalement si -\fBnano\fR reçoit un signal SIGHUP ou SIGTERM, ou bien se trouve à court de -mémoire. Le nom de ce fichier de secours sera \fInano.save\fR si le fichier en -cours n'avait pas encore de nom, ou sera composé du nom du fichier en cours -suivi du suffixe «\ .save\ ». Si un fichier de ce nom existe déjà dans -le répertoire, un «\ .save\ » et un nombre seront ajoutés à la fin du +d'édition dans un fichier de secours. Cela arrivera principalement si +\fBnano\fR reçoit un signal SIGHUP ou SIGTERM, ou bien se trouve à court de +mémoire. Le nom de ce fichier de secours sera \fInano.save\fR si le fichier en +cours n'avait pas encore de nom, ou sera composé du nom du fichier en cours +suivi du suffixe «\ .save\ ». Si un fichier de ce nom existe déjà dans +le répertoire, un «\ .save\ » et un nombre seront ajoutés à la fin du nom du fichier en cours afin de le rendre unique (par exemple, -«\ .save.1\ »). En mode multi-espace, \fBnano\fR réalisera une +«\ .save.1\ »). En mode multi-espace, \fBnano\fR réalisera une sauvegarde de tous les fichiers en cours dans leurs fichiers de secours respectifs. .SH BOGUES Merci de nous faire parvenir vos commentaires et de nous signaler les -bogues, en écrivant, en anglais, à \fBnano@nano-editor.org\fR. +bogues, en écrivant, en anglais, à \fBnano@nano-editor.org\fR. -La liste de discussion anglophone \fBnano\fR est disponible à l'adresse +La liste de discussion anglophone \fBnano\fR est disponible à l'adresse \fBnano-devel@gnu.org\fR. -Pour vous abonner, envoyez un courrier électronique à -\fBnano-devel-request@gnu.org\fR, ayant pour objet «\ subscribe\ ». +Pour vous abonner, envoyez un courrier électronique à +\fBnano-devel-request@gnu.org\fR, ayant pour objet «\ subscribe\ ». -N'hésitez pas également à envoyez vos commentaires, suggestions et -corrections relatives à l'adaptation française de cette page de manuel -ou du logiciel à \fBjean-philippe.guerard@tigreraye.org\fR. +N'hésitez pas également à envoyez vos commentaires, suggestions et +corrections relatives à l'adaptation française de cette page de manuel +ou du logiciel à \fBjean-philippe.guerard@tigreraye.org\fR. .SH "SITE INTERNET" http://www.nano-editor.org/ @@ -300,27 +300,27 @@ http://www.nano-editor.org/ .TP \fBnanorc\fR(5) .PP -\fI/usr/share/doc/nano/\fR (ou son équivalent sur votre système) +\fI/usr/share/doc/nano/\fR (ou son équivalent sur votre système) .SH AUTEUR Chris Allegretta et d'autres (voir les fichiers \fIAUTHORS\fR et \fITHANKS\fR pour plus d'information). Cette page de -manuel a été initialement rédigée par Jordi Mallach pour -le système Debian (mais elle peut être utilisée par d'autres). +manuel a été initialement rédigée par Jordi Mallach pour +le système Debian (mais elle peut être utilisée par d'autres). .SH TRADUCTION -Cette adaptation française a été réalisée par Jean-Philippe\ Guérard - le 29\ novembre\ 2007 à partir +Cette adaptation française a été réalisée par Jean-Philippe\ Guérard + le 29\ novembre\ 2007 à partir de la version 1.54 du 11\ octobre\ 2007 de la page de manuel de nano -2.0.0. Cette page a été relue par Gérard Delafond. +2.0.0. Cette page a été relue par Gérard Delafond. -Un maximum de soin a été apporté lors de l'élaboration de cette -traduction\ ; néanmoins, quelques imperfections peuvent subsister. Si -vous en rencontrez, que ce soit dans la version française ou dans la -version originale, n'hésitez pas à les signaler à l'auteur ou au +Un maximum de soin a été apporté lors de l'élaboration de cette +traduction\ ; néanmoins, quelques imperfections peuvent subsister. Si +vous en rencontrez, que ce soit dans la version française ou dans la +version originale, n'hésitez pas à les signaler à l'auteur ou au traducteur. -La version originale la plus à jour de ce document est toujours +La version originale la plus à jour de ce document est toujours consultable via la commande\ : LANGUAGE=en man nano diff --git a/doc/man/fr/nano.1.html b/doc/man/fr/nano.1.html index e8f9548..e7085e9 100644 --- a/doc/man/fr/nano.1.html +++ b/doc/man/fr/nano.1.html @@ -1,5 +1,5 @@ - - + + @@ -41,8 +41,8 @@

nano − -NAno un NOuvel éditeur, un clone libre et -amélioré de Pico

+NAno un NOuvel éditeur, un clone libre et +amélioré de Pico

SYNOPSIS @@ -58,21 +58,23 @@ amélioré de Pico

Cette page de -manuel décrit brièvement la commande -nano.

+manuel décrit brièvement la +commande nano.

nano est -un éditeur petit, sympathique et libre, qui vise -à remplacer Pico, l’éditeur par -défaut du logiciel non libre Pine. nano ne se -contentant pas de copier l’interface et -l’ergonomie de Pico, il offre également -certaines fonctions manquantes (ou désactivées -par défaut) dans Pico. Ces fonctionnalités -sont, par exemple, les fonctions de recherche et de -remplacement, et la possibilité de sauter directement -à une ligne et à une colonne -précise.

+un éditeur petit, sympathique et libre, qui +vise à remplacer Pico, +l’éditeur par défaut du +logiciel non libre Pine. nano ne se contentant pas de +copier l’interface et l’ergonomie de Pico, il +offre également certaines fonctions manquantes +(ou désactivées par +défaut) dans Pico. Ces +fonctionnalités sont, par exemple, les +fonctions de recherche et de remplacement, et la +possibilité de sauter directement +à une ligne et à une colonne +précise.

OPTIONS @@ -82,11 +84,12 @@ précise.

+LIGNE,COLONNE

-

Démarre avec le curseur -positionné à la colonne COLONNE de la -ligne LIGNE (l’un des deux, au moins, devant -être spécifié) au lieu de -démarrer à la colonne 1, +

Démarre avec le +curseur positionné à la colonne +COLONNE de la ligne LIGNE (l’un des +deux, au moins, devant être +spécifié) au lieu de +démarrer à la colonne 1, ligne 1.

−?

- - +
+ -

Identique à -h (−−help).

 +

Identique à −h +(−−help).
@@ -111,39 +115,42 @@ ligne 1.

Rend plus malin le fonctionnement de la touche -« Début ». Lorsque l’on -appuie sur cette touche à n’importe quel -endroit excepté au tout début du texte -d’une ligne (i. e. au premier caractère -non blanc), le curseur se positionnera au début du -texte de la ligne (qu’il soit en avant ou en -arrière). Si le curseur est déjà -là, il se placera au vrai début de la -ligne.

+« Début Â». +Lorsque l’on appuie sur cette touche à +n’importe quel endroit excepté au tout +début du texte d’une ligne (i. e. au +premier caractère non blanc), le curseur se +positionnera au début du texte de la ligne +(qu’il soit en avant ou en arrière). Si le +curseur est déjà là, +il se placera au vrai début de la ligne.

−B (−−backup)

-

Lors de l’écriture -d’un fichier, crée une copie de -sécurité de la version -précédente, en ajoutant un tilde (~) au nom du -fichier.

+

Lors de +l’écriture d’un fichier, +crée une copie de +sécurité de la version +précédente, en ajoutant un tilde +(~) au nom du fichier.

−D (−−boldtext)

-

Utilise des caractères -gras à la place de la vidéo inverse.

+

Utilise des +caractères gras à la place de la +vidéo inverse.

−C -répertoire -(−−backupdir=répertoire)

+répertoire +(−−backupdir=répertoire)

-

Définit le -répertoire utilisé par nano pour -enregistrer les copies de sécurité uniques si -celles-ci sont activées.

+

Définit le +répertoire utilisé par nano +pour enregistrer les copies de +sécurité uniques si celles-ci sont +activées.

−E (−−tabstospaces)

@@ -155,18 +162,20 @@ clavier en espaces.

(−−multibuffer)

Active le mode multi-espace, -autorisant l’édition simultanée de -plusieurs fichiers, si ce mode est disponible.

+autorisant l’édition +simultanée de plusieurs fichiers, si ce mode +est disponible.

−H (−−historylog)

-

Enregistre les chaînes -ayant fait l’objet d’une recherche ou d’un -remplacement dans le fichier ~/.nano_history afin de -permettre leur réutilisation. Ceci n’est -possible que si nano est configuré pour -utiliser les fichiers nanorc.

+

Enregistre les +chaînes ayant fait l’objet d’une +recherche ou d’un remplacement dans le fichier +~/.nano_history afin de permettre leur +réutilisation. Ceci n’est possible que si +nano est configuré pour utiliser les +fichiers nanorc.

−I (−−ignorercfiles)

@@ -178,110 +187,120 @@ fichiers SYSCONFDIR/nanorc et ~/.nanorc (si

−K (−−rebindkeypad)

-

Interprète les touches -du pavé numérique afin qu’elles -fonctionnent toutes correctement. Vous ne devriez utiliser -cette option que si ce n’est pas le cas, car nano ne -sera plus capable d’utiliser la souris correctement -lorsque cette option sera activée.

+

Interprète les +touches du pavé numérique afin +qu’elles fonctionnent toutes correctement. Vous ne +devriez utiliser cette option que si ce n’est pas le +cas, car nano ne sera plus capable d’utiliser la +souris correctement lorsque cette option sera +activée.

−L (−−nonewlines)

Ne pas ajouter de passage -à la ligne à la fin des fichiers.

+à la ligne à la fin des +fichiers.

−N (−−noconvert)

-

Désactive la conversion -automatique des fichiers depuis les formats Mac et DOS.

+

Désactive la +conversion automatique des fichiers depuis les formats Mac +et DOS.

−O (−−morespace)

Utiliser la ligne blanche -située sous la ligne de titre comme espace -supplémentaire d’édition.

+située sous la ligne de titre comme espace +supplémentaire +d’édition.

−Q -chaîne -(−−quotestr=chaîne)

- -

Définit le -préfixe par défaut des citations. Nano utilise -ce préfixe pour réaliser une justification -correcte des citations. Si nano est capable d’utiliser -des expressions rationnelles, le préfixe par -défaut sera +chaîne +(−−quotestr=chaîne)

+ +

Définit le +préfixe par défaut des citations. +Nano utilise ce préfixe pour +réaliser une justification correcte des +citations. Si nano est capable d’utiliser des +expressions rationnelles, le préfixe par +défaut sera "^([ \t]*[#:>\|}])+", sinon, ce sera "> ". Dans l’expression -rationnelle précédente, -« \t » représente une -tabulation.

+rationnelle précédente, +« \t Â» +représente une tabulation.

−R (−−restricted)

Mode restreint : aucune -lecture ou écriture de fichiers non indiqués -sur la ligne de commande, pas de lecture des fichiers -nanorc, interdiction de suspendre, interdiction -d’ajouter au début, à la fin, de -sauvegarder un fichier ayant déjà un nom sous -un nom différent, d’utiliser une copie de -sécurité ou le correcteur orthographique. -Cette option peut aussi être activée en -appelant nano sous un nom commençant par -« r » (par exemple -« rnano »).

+lecture ou écriture de fichiers non +indiqués sur la ligne de commande, pas de +lecture des fichiers nanorc, interdiction de suspendre, +interdiction d’ajouter au début, +à la fin, de sauvegarder un fichier ayant +déjà un nom sous un nom +différent, d’utiliser une copie de +sécurité ou le correcteur +orthographique. Cette option peut aussi être +activée en appelant nano sous un nom +commençant par +« r Â» (par exemple +« rnano Â»).

−S (−−smooth)

-

Active le défilement -progressif. Le texte défilera ligne-par-ligne au lieu -de défiler morceau-par-morceau.

+

Active le +défilement progressif. Le texte +défilera ligne-par-ligne au lieu de +défiler morceau-par-morceau.

−T nombre (−−tabsize=nombre)

-

Définit la taille +

Définit la taille (largeur) des tabulations en nombre de colonnes. Le nombre -indiqué doit être strictement supérieur -à 0. La valeur par défaut est de 8.

+indiqué doit être strictement +supérieur à 0. La valeur par +défaut est de 8.

−U (−−quickblank)

Effacement rapide de la ligne -d’état. Les messages affichés par la -ligne d’état disparaîtront après -une frappe clavier au lieu de 25. Notez que l’option --c prend le pas sur cette option.

+d’état. Les messages +affichés par la ligne d’état +disparaîtront après une frappe +clavier au lieu de 25. Notez que l’option -c +prend le pas sur cette option.

−V (−−version)

Affiche la version, puis -s’arrête.

+s’arrête.

−W (−−wordbounds)

-

Détection plus -précise des limites de mots, obtenue en -considérant les caractères de ponctuation -comme faisant partie des mots.

+

Détection plus +précise des limites de mots, obtenue en +considérant les caractères de +ponctuation comme faisant partie des mots.

−Y -chaîne -(−−syntax=chaîne)

+chaîne +(−−syntax=chaîne)

Indique quel mode de colorisation syntaxique adopter, parmi les modes -définis dans le fichier .nanorc, si cette -fonctionnalité est disponible.

+définis dans le fichier .nanorc, si +cette fonctionnalité est disponible.

−c (−−const)

@@ -293,89 +312,95 @@ l’option -U.

−d (−−rebinddelete)

-

Interprète -différemment la touche -« Supprimer », afin que les touches -« Effacement arrière » et -« Supprimer » fonctionnent -correctement. Vous ne devriez avoir besoin de cette option -que si, sur votre système, la touche -« Effacement arrière » produit +

Interprète +différemment la touche +« Supprimer Â», afin que +les touches « Effacement +arrière Â» et +« Supprimer Â» +fonctionnent correctement. Vous ne devriez avoir besoin de +cette option que si, sur votre système, la +touche « Effacement +arrière Â» produit l’effet de la touche -« Supprimer ».

+« Supprimer Â».

−h (−−help)

-

Affiche un résumé -des options de lancement de nano, puis -s’arrête.

+

Affiche un +résumé des options de lancement de +nano, puis s’arrête.

−i (−−autoindent)

Indentation automatique. -Commence chaque nouvelle ligne au même niveau que la -ligne précédente. Utile pour -l’édition de code source.

+Commence chaque nouvelle ligne au même niveau +que la ligne précédente. Utile +pour l’édition de code source.

−k (−−cut)

Coupe le texte du curseur -à la fin de la ligne, au lieu de couper la ligne -entière.

+à la fin de la ligne, au lieu de couper la +ligne entière.

−l (−−nofollow)

Si le fichier -édité est un lien symbolique, au lieu de le -suivre, remplace le lien par le nouveau fichier. Sans doute -utile pour éditer les fichiers de /tmp, -non ?

+édité est un lien symbolique, au +lieu de le suivre, remplace le lien par le nouveau fichier. +Sans doute utile pour éditer les fichiers de +/tmp, non ?

−m (−−mouse)

Active l’utilisation de -la souris, si elle est disponible pour votre système. -Lorsque celle-ci est activée, il est possible -d’utiliser la souris pour positionner le curseur, pour -marquer le texte (avec un double-clic) et pour lancer les -fonctions correspondant aux raccourcis. Il est possible +la souris, si elle est disponible pour votre +système. Lorsque celle-ci est +activée, il est possible d’utiliser la +souris pour positionner le curseur, pour marquer le texte +(avec un double-clic) et pour lancer les fonctions +correspondant aux raccourcis. Il est possible d’utiliser la souris sous X Window ou en mode console avec gpm.

−o -répertoire -(−−operatingdir=répertoire)

- -

Définit le -répertoire de travail. Demande à nano -de mettre en place quelque chose de similaire à un -environnement d’exécution restreint +répertoire +(−−operatingdir=répertoire)

+ +

Définit le +répertoire de travail. Demande à +nano de mettre en place quelque chose de similaire +à un environnement +d’exécution restreint (chroot).

−p (−−preserve)

-

Préserve les -séquences XON et XOFF (^Q et ^S), afin qu’elle -soient reçues par le terminal.

+

Préserve les +séquences XON et XOFF (^Q et ^S), afin +qu’elle soient reçues par le +terminal.

−r colonne (−−fill=colonne)

-

Passe automatiquement à -la ligne une fois arrivé à la colonne -colonne. Si la valeur indiquée est de 0 ou -moins, le point de passage à la ligne aura lieu -à la taille de l’écran moins -colonne. Cela permet de faire varier le point de -passage à la ligne lorsque l’on change la -taille de l’écran. La valeur par défaut -est de −8.

+

Passe automatiquement +à la ligne une fois arrivé +à la colonne colonne. Si la valeur +indiquée est de 0 ou moins, le point de passage +à la ligne aura lieu à la taille +de l’écran moins colonne. Cela +permet de faire varier le point de passage à la +ligne lorsque l’on change la taille de +l’écran. La valeur par +défaut est de −8.

−s programme @@ -387,10 +412,11 @@ orthographique de remplacement.

−t (−−tempfile)

-

S’il a été -modifié, le fichier sera sauvegardé -automatiquement sans demande de confirmation. Identique -à l’option -t de Pico.

+

S’il a +été modifié, le +fichier sera sauvegardé automatiquement sans +demande de confirmation. Identique à +l’option -t de Pico.

−v (−−view)

@@ -401,27 +427,27 @@ seule).

−w (−−nowrap)

-

Désactive le passage -automatique à la ligne.

+

Désactive le +passage automatique à la ligne.

−x (−−nohelp)

-

Désactive la barre -d’aide affichée en bas de -l’écran.

+

Désactive la barre +d’aide affichée en bas de +l’écran.

−z (−−suspend)

-

Autorise à suspendre -l’éditeur.

+

Autorise à +suspendre l’éditeur.

−a, −b, −e, −f, −g, −j

-

Ignoré, pour être -compatible avec Pico.

+

Ignoré, pour +être compatible avec Pico.

FICHIERS D’INITIALISATION @@ -431,10 +457,11 @@ compatible avec Pico.

nano lit les fichiers d’initialisation dans l’ordre suivant : SYSCONFDIR/nanorc, puis -~/.nanorc. Référez-vous à la -page de manuel de nanorc(5) et au fichier -d’exemple nanorc.sample, qui devraient tous les -deux être livrés avec nano.

+~/.nanorc. Référez-vous +à la page de manuel de nanorc(5) et au +fichier d’exemple nanorc.sample, qui devraient +tous les deux être livrés avec +nano.

NOTES @@ -443,28 +470,31 @@ deux être livrés avec nano.

Si aucun correcteur orthographique de remplacement n’est -indiqué dans la ligne de commande ou dans l’un -des fichiers nanorc, nano prendra la commande -indiquée par la variable d’environnement -SPELL si elle est définie.

+indiqué dans la ligne de commande ou dans +l’un des fichiers nanorc, nano prendra la +commande indiquée par la variable +d’environnement SPELL si elle est +définie.

Dans certains cas, nano essaiera de sauvegarder le fichier en cours -d’édition dans un fichier de secours. Cela -arrivera principalement si nano reçoit un -signal SIGHUP ou SIGTERM, ou bien se trouve à court -de mémoire. Le nom de ce fichier de secours sera -nano.save si le fichier en cours n’avait pas -encore de nom, ou sera composé du nom du fichier en -cours suivi du suffixe « .save ». Si -un fichier de ce nom existe déjà dans le -répertoire, un « .save » et un -nombre seront ajoutés à la fin du nom du +d’édition dans un fichier de secours. +Cela arrivera principalement si nano +reçoit un signal SIGHUP ou SIGTERM, ou bien se +trouve à court de mémoire. Le nom +de ce fichier de secours sera nano.save si le fichier +en cours n’avait pas encore de nom, ou sera +composé du nom du fichier en cours suivi du +suffixe « .save Â». Si un +fichier de ce nom existe déjà dans +le répertoire, un +« .save Â» et un nombre +seront ajoutés à la fin du nom du fichier en cours afin de le rendre unique (par exemple, -« .save.1 »). En mode multi-espace, -nano réalisera une sauvegarde de tous les -fichiers en cours dans leurs fichiers de secours -respectifs.

+« .save.1 Â»). En mode +multi-espace, nano réalisera une +sauvegarde de tous les fichiers en cours dans leurs fichiers +de secours respectifs.

BOGUES @@ -473,24 +503,25 @@ respectifs.

Merci de nous faire parvenir vos commentaires et de nous signaler les -bogues, en écrivant, en anglais, à +bogues, en écrivant, en anglais, à nano@nano-editor.org.

La liste de -discussion anglophone nano est disponible à -l’adresse nano-devel@gnu.org.

+discussion anglophone nano est disponible +à l’adresse +nano-devel@gnu.org.

Pour vous -abonner, envoyez un courrier électronique à -nano-devel-request@gnu.org, ayant pour objet -« subscribe ».

+abonner, envoyez un courrier électronique +à nano-devel-request@gnu.org, ayant pour +objet « subscribe Â».

-

N’hésitez -pas également à envoyez vos commentaires, -suggestions et corrections relatives à -l’adaptation française de cette page de manuel -ou du logiciel à +

N’hésitez +pas également à envoyez vos +commentaires, suggestions et corrections relatives +à l’adaptation française de +cette page de manuel ou du logiciel à jean-philippe.guerard@tigreraye.org.

SITE INTERNET @@ -509,8 +540,8 @@ ou du logiciel à

nanorc(5)
-/usr/share/doc/nano/ (ou son équivalent sur votre -système)

+/usr/share/doc/nano/ (ou son équivalent sur +votre système)

AUTEUR @@ -521,9 +552,10 @@ système)

Allegretta <chrisa@asty.org> et d’autres (voir les fichiers AUTHORS et THANKS pour plus d’information). Cette page de manuel a -été initialement rédigée par -Jordi Mallach <jordi@gnu.org> pour le système -Debian (mais elle peut être utilisée par +été initialement +rédigée par Jordi Mallach +<jordi@gnu.org> pour le système Debian +(mais elle peut être utilisée par d’autres).

TRADUCTION @@ -532,26 +564,30 @@ d’autres).

Cette -adaptation française a été -réalisée par Jean-Philippe Guérard +adaptation française a +été +réalisée par +Jean-Philippe Guérard <jean-philippe.guerard@tigreraye.org> le -29 novembre 2007 à partir de la version -1.54 du 11 octobre 2007 de la page de manuel de -nano 2.0.0. Cette page a été relue par -Gérard Delafond.

+29 novembre 2007 à partir de la +version 1.54 du 11 octobre 2007 de la page de +manuel de nano 2.0.0. Cette page a +été relue par Gérard +Delafond.

Un maximum de -soin a été apporté lors de -l’élaboration de cette traduction ; -néanmoins, quelques imperfections peuvent subsister. -Si vous en rencontrez, que ce soit dans la version -française ou dans la version originale, -n’hésitez pas à les signaler à -l’auteur ou au traducteur.

+soin a été apporté +lors de l’élaboration de cette +traduction ; néanmoins, quelques +imperfections peuvent subsister. Si vous en rencontrez, que +ce soit dans la version française ou dans la +version originale, n’hésitez pas +à les signaler à l’auteur ou +au traducteur.

La version -originale la plus à jour de ce document est toujours -consultable via la commande :

+originale la plus à jour de ce document est +toujours consultable via la commande :

LANGUAGE=en man nano

diff --git a/doc/man/fr/nanorc.5 b/doc/man/fr/nanorc.5 index 0607045..9c25635 100644 --- a/doc/man/fr/nanorc.5 +++ b/doc/man/fr/nanorc.5 @@ -2,14 +2,14 @@ .\" Copyright (C) 2003, 2004, 2005, 2006, 2007 .\" Free Software Foundation, Inc. .\" -.\" Le travail d'adaptation française de cette page de manuel a été -.\" réalisé par Jean-Philippe Guérard, en 2003, 2004, 2005, 2006 et 2007. +.\" Le travail d'adaptation française de cette page de manuel a été +.\" réalisé par Jean-Philippe Guérard, en 2003, 2004, 2005, 2006 et 2007. .\" Ce travail d'adaptation est dans le domaine public. Attention, la .\" page traduite reste soumise au droit d'auteur de ses auteurs .\" originaux. .\" .\" The French translation of this document is a public domain work of -.\" Jean-Philippe Guérard. This translation work was made in 2003, 2004, +.\" Jean-Philippe Guérard. This translation work was made in 2003, 2004, .\" 2005, 2006 and 2007. The translated man page in itself is still .\" subject to the copyright of its original authors. .\" @@ -29,71 +29,71 @@ .\" Documentation License along with this program. If not, see .\" . .\" -.\" Ce document est publié sous une double licence. Vous pouvez +.\" Ce document est publié sous une double licence. Vous pouvez .\" le distribuer et le modifier selon les termes de l'une des deux -.\" licences ci-dessous : +.\" licences ci-dessous : .\" -.\" * La Licence publique générale GNU (GNU GPL) version 3 ou, à -.\" votre choix, supérieure, telle que publiée par la Free -.\" Software Foundation. Vous devriez avoir reçu une copie de la -.\" Licence publique générale GNU avec ce programme. Si ce n'est +.\" * La Licence publique générale GNU (GNU GPL) version 3 ou, à +.\" votre choix, supérieure, telle que publiée par la Free +.\" Software Foundation. Vous devriez avoir reçu une copie de la +.\" Licence publique générale GNU avec ce programme. Si ce n'est .\" pas le cas, consultez . .\" .\" * La Licence de documentation libre GNU (GNU FDL), version 1.2 -.\" ou, à votre choix, supérieure, telle que publiée par la Free +.\" ou, à votre choix, supérieure, telle que publiée par la Free .\" Software Foundation, sans section invariante, ni texte de -.\" première ou de quatrième de couverture. Vous devriez avoir reçu +.\" première ou de quatrième de couverture. Vous devriez avoir reçu .\" une copie de la Licence de documentation libre GNU avec ce .\" programme. Si ce n'est pas le cas, consultez .\" . .\" -.\" $Id: nanorc.5 4443 2009-11-27 02:50:12Z astyanax $ +.\" $Id: nanorc.5 5071 2014-07-16 17:25:55Z jordi $ .TH NANORC 5 "version 2.0.0" "29\ novembre\ 2007" .\" Please adjust this date whenever revising the manpage. -.\" Merci de modifier ces dates à chaque mise à jour de cette page. +.\" Merci de modifier ces dates à chaque mise à jour de cette page. .SH NOM -nanorc \- fichier de configuration de l'éditeur nano du projet GNU +nanorc \- fichier de configuration de l'éditeur nano du projet GNU .SH DESCRIPTION -Cette page de manuel décrit brièvement le fichier de configuration de -l'éditeur \fBnano\fP GNU. +Cette page de manuel décrit brièvement le fichier de configuration de +l'éditeur \fBnano\fP GNU. .PP -\fBnano\fP est un petit éditeur sympathique et libre, qui vise à -remplacer Pico, l'éditeur par défaut du logiciel non libre Pine. +\fBnano\fP est un petit éditeur sympathique et libre, qui vise à +remplacer Pico, l'éditeur par défaut du logiciel non libre Pine. \fBnano\fP ne se contentant pas de copier l'interface et l'ergonomie de -Pico, il offre également certaines fonctionnalités manquantes (ou -désactivées par défaut) de Pico. Ces fonctionnalités sont, par exemple, -les fonctions de recherche et de remplacement et la possibilité de -sauter directement à une ligne et à une colonne précise. +Pico, il offre également certaines fonctionnalités manquantes (ou +désactivées par défaut) de Pico. Ces fonctionnalités sont, par exemple, +les fonctions de recherche et de remplacement et la possibilité de +sauter directement à une ligne et à une colonne précise. .PP -Le fichier \fInanorc\fP contient les paramètres par défaut de -\fBnano\fP. Il ne doit pas être au format DOS ou Mac. Lors de son -démarrage, nano commencera par lire le fichier de configuration général +Le fichier \fInanorc\fP contient les paramètres par défaut de +\fBnano\fP. Il ne doit pas être au format DOS ou Mac. Lors de son +démarrage, nano commencera par lire le fichier de configuration général \fISYSCONFDIR/nanorc\fP, puis lira le fichier de configuration personnel de l'utilisateur \fI~/.nanorc\fP. .SH OPTIONS -Le fichier de configuration accepte une série de commandes \fBset\fP -(activer) et \fBunset\fP (désactiver), qui permettent de définir le -paramétrage de nano au démarrage sans avoir à utiliser d'options de +Le fichier de configuration accepte une série de commandes \fBset\fP +(activer) et \fBunset\fP (désactiver), qui permettent de définir le +paramétrage de nano au démarrage sans avoir à utiliser d'options de ligne de commande. De plus, les mots clefs \fBsyntax\fP (syntaxe), -\fBcolor\fP (couleur) et \fBicolor\fP (couleur insensible à la casse) -sont utilisés pour définir les règles de colorisation pour différents +\fBcolor\fP (couleur) et \fBicolor\fP (couleur insensible à la casse) +sont utilisés pour définir les règles de colorisation pour différents motifs de texte. \fBnano\fP lit une commande par ligne. -Les options du fichier de configuration ont priorité sur les valeurs par -défaut utilisées par nano. Les options de la ligne de commande sont +Les options du fichier de configuration ont priorité sur les valeurs par +défaut utilisées par nano. Les options de la ligne de commande sont prioritaires par rapport aux options du fichier de configuration. Les -options sont désactivées (unset) par défaut, sauf les options prenant un +options sont désactivées (unset) par défaut, sauf les options prenant un argument. -Les apostrophes («\ \fI'\fP\ ») et les guillemets droits («\ \fI"\fP\ ») -présents dans des chaînes de caractères utilisées comme paramètres n'ont -pas besoin d'être précédées d'une barre oblique inversée -(«\ \fI\\\fP\ »). La chaîne sera terminée par le dernier guillemet +Les apostrophes («\ \fI'\fP\ ») et les guillemets droits («\ \fI"\fP\ ») +présents dans des chaînes de caractères utilisées comme paramètres n'ont +pas besoin d'être précédées d'une barre oblique inversée +(«\ \fI\\\fP\ »). La chaîne sera terminée par le dernier guillemet droit. Par exemple, pour l'option \fBbrackets\fP, "\fI"')>]}\fP" -correspondra à \fI"\fP, \fI'\fP, \fI)\fP, \fI>\fP, \fI]\fP et \fI}\fP. +correspondra à \fI"\fP, \fI'\fP, \fI)\fP, \fI>\fP, \fI]\fP et \fI}\fP. Les commandes et arguments reconnus sont\ : @@ -102,69 +102,69 @@ Les commandes et arguments reconnus sont\ : Active l'indentation automatique. .TP .B set/unset backup -Crée des copies de sécurité nommées +Crée des copies de sécurité nommées .IR nom_du_fichier~ . .TP -.B set backupdir "\fIrépertoire\fP" -Définit le répertoire utilisé par \fBnano\fP pour enregistrer les copies -de sécurité uniques, si l'enregistrement de copies de sécurité est -activé. +.B set backupdir "\fIrépertoire\fP" +Définit le répertoire utilisé par \fBnano\fP pour enregistrer les copies +de sécurité uniques, si l'enregistrement de copies de sécurité est +activé. .TP .B set/unset backwards -Par défaut, les recherches se font vers l'arrière. +Par défaut, les recherches se font vers l'arrière. .TP .B set/unset boldtext -Utilise des caractères gras à la place de la vidéo inverse. +Utilise des caractères gras à la place de la vidéo inverse. .TP -.B set brackets "\fIchaîne\fP" -Définit les caractères considérés comme des crochets fermants lors de la -justification des paragraphes. Ces caractères ne doivent pas contenir -d'espaces. Seules les ponctuations terminales, éventuellement suivies +.B set brackets "\fIchaîne\fP" +Définit les caractères considérés comme des crochets fermants lors de la +justification des paragraphes. Ces caractères ne doivent pas contenir +d'espaces. Seules les ponctuations terminales, éventuellement suivies de crochets fermants, peuvent terminer une phrase. -La valeur par défaut de cette option est\ : "\fI"')>]}\fP". +La valeur par défaut de cette option est\ : "\fI"')>]}\fP". N.D.T.\ : reportez-vous au paragraphe sur l'option \fBpunct\fR pour plus d'informations. .TP .B set/unset casesensitive -Par défaut, les recherches ne tiennent pas compte de la casse. +Par défaut, les recherches ne tiennent pas compte de la casse. .TP .B set/unset const -Affiche en permanence la position du curseur dans la ligne d'état. +Affiche en permanence la position du curseur dans la ligne d'état. .TP .B set/unset cut -Par défaut, coupe le texte du curseur à la fin de la ligne, au lieu de -couper la ligne entière. +Par défaut, coupe le texte du curseur à la fin de la ligne, au lieu de +couper la ligne entière. .TP .B set fill \fIn\fP -Passe automatiquement à la ligne une fois arrivé à la colonne -\fIn\fR. Si la valeur indiquée est de 0 ou moins, le point de passage à -la ligne aura lieu à la taille de l'écran moins \fIn\fR. Cela permet de -faire varier le point de passage à la ligne lorsque l'on change la -taille de l'écran. La valeur par défaut est de \-8. +Passe automatiquement à la ligne une fois arrivé à la colonne +\fIn\fR. Si la valeur indiquée est de 0 ou moins, le point de passage à +la ligne aura lieu à la taille de l'écran moins \fIn\fR. Cela permet de +faire varier le point de passage à la ligne lorsque l'on change la +taille de l'écran. La valeur par défaut est de \-8. .TP .B set/unset historylog Active l'utilisation de .I ~/.nano_history -pour enregistrer et relire les chaînes ayant fait l'objet d'une +pour enregistrer et relire les chaînes ayant fait l'objet d'une recherche ou d'un remplacement. .TP -.B set matchbrackets "\fIchaîne\fP" -Définit les crochets ouvrants et fermant pour la recherche de crochets +.B set matchbrackets "\fIchaîne\fP" +Définit les crochets ouvrants et fermant pour la recherche de crochets correspondants. Cette liste ne doit pas contenir de blancs. L'ensemble -des crochets ouvrants doit être indiqué en premier, suivi de l'ensemble -des crochets fermant, qui doit être dans le même ordre. La valeur par -défaut de cette option est "\fI(<[{)>]}\fP". +des crochets ouvrants doit être indiqué en premier, suivi de l'ensemble +des crochets fermant, qui doit être dans le même ordre. La valeur par +défaut de cette option est "\fI(<[{)>]}\fP". .TP .B set/unset morespace -Utiliser la ligne blanche située sous la ligne de titre comme espace -supplémentaire d'édition. +Utiliser la ligne blanche située sous la ligne de titre comme espace +supplémentaire d'édition. .TP .B set/unset mouse Active l'utilisation de la souris, si elle est disponible pour votre -système. Lorsque celle-ci est activée, il est possible d'utiliser la +système. Lorsque celle-ci est activée, il est possible d'utiliser la souris pour positionner le curseur, pour marquer le texte (avec un double-clic) et pour lancer les fonctions correspondant aux raccourcis. Il est possible d'utiliser la souris sous X\ Window ou en mode console @@ -178,167 +178,167 @@ espace. Pas de conversion depuis les formats DOS et Mac. .TP .B set/unset nofollow -Ne suit pas les liens symboliques lors de l'écriture des fichiers. +Ne suit pas les liens symboliques lors de l'écriture des fichiers. .TP .B set/unset nohelp -Désactive les lignes d'aide affichée en bas de l'écran. +Désactive les lignes d'aide affichée en bas de l'écran. .TP .B set/unset nonewlines -Ne pas ajouter de passage à la ligne à la fin des fichiers. +Ne pas ajouter de passage à la ligne à la fin des fichiers. .TP .B set/unset nowrap -Désactive le passage automatique à la ligne. +Désactive le passage automatique à la ligne. .TP -.B set operatingdir "\fIrépertoire\fP" -\fBnano\fP ne lira et n'écrira des fichiers qu'à l'intérieur du -\fIrépertoire\fP et de ses sous-répertoires. De plus, celui-ci devient -le répertoire courant, afin que les fichiers soient lus depuis ce -répertoire. Par défaut, cette fonction est désactivée. +.B set operatingdir "\fIrépertoire\fP" +\fBnano\fP ne lira et n'écrira des fichiers qu'à l'intérieur du +\fIrépertoire\fP et de ses sous-répertoires. De plus, celui-ci devient +le répertoire courant, afin que les fichiers soient lus depuis ce +répertoire. Par défaut, cette fonction est désactivée. .TP .B set/unset preserve -Préserve les séquences XON et XOFF (^Q et ^S). +Préserve les séquences XON et XOFF (^Q et ^S). .TP -.B set punct "\fIchaîne\fP" -Définit les caractères interprétés comme des ponctuations terminales -lors de la justification des paragraphes. Ces caractères ne peuvent -inclure de blancs. Seules les ponctuations terminales, éventuellement +.B set punct "\fIchaîne\fP" +Définit les caractères interprétés comme des ponctuations terminales +lors de la justification des paragraphes. Ces caractères ne peuvent +inclure de blancs. Seules les ponctuations terminales, éventuellement suivies de crochets fermants, peuvent terminer une phrase. La valeur par -défaut de cette option est "\fI!.?\fP". +défaut de cette option est "\fI!.?\fP". -N.D.T.\ : ce réglage permet, lors de la justification, de conserver -2\ espaces au lieu d'une derrière les ponctuations terminales, ce qui +N.D.T.\ : ce réglage permet, lors de la justification, de conserver +2\ espaces au lieu d'une derrière les ponctuations terminales, ce qui correspond aux normes typographiques anglo-saxonnes, mais n'a pas lieu -d'être en français. Pour le français, le plus simple est d'indiquer, -dans le fichier nanorc, une chaîne vide pour ce paramètre. +d'être en français. Pour le français, le plus simple est d'indiquer, +dans le fichier nanorc, une chaîne vide pour ce paramètre. .TP .B set/unset quickblank -Effacement rapide de la ligne d'état. Les messages affichés par la ligne -d'état disparaîtront après une frappe clavier au lieu de 25. -.TP -.B set quotestr "\fIchaîne\fP" -Définit le préfixe par défaut utilisé pour les citations dans les -courriers électroniques. Ce préfixe est utilisé pour réaliser une -justification correcte de ces citations. Il s'agira, si votre système le -permet, d'une expression rationnelle étendue. Dans le cas -contraire, il s'agira d'une chaîne de texte brut. Si vous disposez des -expressions rationnelles, la valeur par défaut de cette option sera +Effacement rapide de la ligne d'état. Les messages affichés par la ligne +d'état disparaîtront après une frappe clavier au lieu de 25. +.TP +.B set quotestr "\fIchaîne\fP" +Définit le préfixe par défaut utilisé pour les citations dans les +courriers électroniques. Ce préfixe est utilisé pour réaliser une +justification correcte de ces citations. Il s'agira, si votre système le +permet, d'une expression rationnelle étendue. Dans le cas +contraire, il s'agira d'une chaîne de texte brut. Si vous disposez des +expressions rationnelles, la valeur par défaut de cette option sera "\fI^([\ \\t]*[#:>\\|}])+\fP", sinon, ce sera ">\ ". Notez que le -«\ \\t\ » ci-dessus correspond à un caractère de tabulation. +«\ \\t\ » ci-dessus correspond à un caractère de tabulation. .TP .B set/unset rebinddelete -Interprète différemment la touche «\ Supprimer\ », afin que les touches -«\ Effacement arrière\ » et «\ Supprimer\ » fonctionnent correctement. -Vous ne devriez avoir besoin de cette option que si, sur votre système, -la touche «\ Effacement arrière\ » produit l'effet de la touche «\ -Supprimer\ ». +Interprète différemment la touche «\ Supprimer\ », afin que les touches +«\ Effacement arrière\ » et «\ Supprimer\ » fonctionnent correctement. +Vous ne devriez avoir besoin de cette option que si, sur votre système, +la touche «\ Effacement arrière\ » produit l'effet de la touche «\ +Supprimer\ ». .TP .B set/unset rebindkeypad -Interprète les touches du pavé numérique afin qu'elles fonctionnent +Interprète les touches du pavé numérique afin qu'elles fonctionnent toutes correctement. Vous ne devriez utiliser cette option que si ce n'est pas le cas, car nano ne sera plus capable d'utiliser la souris -correctement lorsque cette option sera activée. +correctement lorsque cette option sera activée. .TP .B set/unset regexp -Utilise par défaut des expressions rationnelles étendues pour les +Utilise par défaut des expressions rationnelles étendues pour les recherches. .TP .B set/unset smarthome -Rend plus malin le fonctionnement de la touche «\ Début\ ». Lorsque -cette touche est pressée à n'importe quel endroit excepté au tout début -du texte d'une ligne (i.\ e. au premier caractère non blanc), le curseur -se positionnera au début du texte de la ligne (qu'il soit en avant ou en -arrière). Si le curseur est déjà là, il se placera au vrai début de la +Rend plus malin le fonctionnement de la touche «\ Début\ ». Lorsque +cette touche est pressée à n'importe quel endroit excepté au tout début +du texte d'une ligne (i.\ e. au premier caractère non blanc), le curseur +se positionnera au début du texte de la ligne (qu'il soit en avant ou en +arrière). Si le curseur est déjà là, il se placera au vrai début de la ligne. .TP .B set/unset smooth -Active le défilement ligne-par-ligne du texte. +Active le défilement ligne-par-ligne du texte. .TP .B set speller "\fIprogramme\fP" Utilise le correcteur orthographique \fIprogramme\fP au lieu du -correcteur intégré, qui s'appuie sur \fIspell\fP. +correcteur intégré, qui s'appuie sur \fIspell\fP. .TP .B set/unset suspend -Autorise à suspendre \fBnano\fP. +Autorise à suspendre \fBnano\fP. .TP .B set tabsize \fIn\fP Utilise une taille de tabulation de \fIn\fP colonnes. Cette valeur doit -être strictement supérieure à 0. La valeur par défaut est de\ 8. +être strictement supérieure à 0. La valeur par défaut est de\ 8. .TP .B set/unset tabstospaces Convertit les tabulations clavier en espaces. .TP .B set/unset tempfile -S'il a été modifié, le fichier sera sauvegardé automatiquement en +S'il a été modifié, le fichier sera sauvegardé automatiquement en quittant, sans demande de confirmation. .TP .B set/unset view Interdit de modifier les fichiers. .TP -.B set whitespace "\fIchaîne\fP" -Définit les deux caractères utilisés pour afficher les premiers -caractères des tabulations et des espaces. Ces deux caractères doivent -être mono-colonne. +.B set whitespace "\fIchaîne\fP" +Définit les deux caractères utilisés pour afficher les premiers +caractères des tabulations et des espaces. Ces deux caractères doivent +être mono-colonne. .TP .B set/unset wordbounds -Détection plus précise des limites de mots, obtenue en considérant les -caractères de ponctuation comme faisant partie des mots. +Détection plus précise des limites de mots, obtenue en considérant les +caractères de ponctuation comme faisant partie des mots. .TP -.B syntax "\fIchaîne\fP" ["\fImotif_de_fichier\fP" ... ] -Définit une syntaxe nommée \fIchaîne\fP qui pourra être activé via +.B syntax "\fIchaîne\fP" ["\fImotif_de_fichier\fP" ... ] +Définit une syntaxe nommée \fIchaîne\fP qui pourra être activé via l'option \fB-Y\fP (ou \fB--syntax\fP) ou qui sera automatiquement -activée si le nom du fichier en cours correspond à l'expression -rationnelle étendue \fImotif_de_fichier\fP. Toutes les instructions -suivantes de colorisation \fBcolor\fP ou \fBicolor\fP s'appliqueront à -cette syntaxe, jusqu'à la définition d'une nouvelle syntaxe. +activée si le nom du fichier en cours correspond à l'expression +rationnelle étendue \fImotif_de_fichier\fP. Toutes les instructions +suivantes de colorisation \fBcolor\fP ou \fBicolor\fP s'appliqueront à +cette syntaxe, jusqu'à la définition d'une nouvelle syntaxe. -La syntaxe nommée \fInone\fP (aucune) est réservée\ ; si elle est -indiquée dans la ligne de commande, cela revient à ne définir aucune -syntaxe. La syntaxe nommée \fIdefault\fP (par défaut) est spéciale, elle -ne nécessite aucun motif de \fImotif_de_fichier\fP, et s'applique aux -fichiers ne correspondant à aucun des \fImotif_de_fichier\fP des autres +La syntaxe nommée \fInone\fP (aucune) est réservée\ ; si elle est +indiquée dans la ligne de commande, cela revient à ne définir aucune +syntaxe. La syntaxe nommée \fIdefault\fP (par défaut) est spéciale, elle +ne nécessite aucun motif de \fImotif_de_fichier\fP, et s'applique aux +fichiers ne correspondant à aucun des \fImotif_de_fichier\fP des autres syntaxes. .TP .B color \fIcouleur_texte\fP[,\fIcouleur_fond\fP] "\fImotif\fP" ... -Pour la syntaxe en cours, affiche toutes les expressions correspondant à -l'expression rationnelle étendue \fImotif\fP en utilisant la couleur de +Pour la syntaxe en cours, affiche toutes les expressions correspondant à +l'expression rationnelle étendue \fImotif\fP en utilisant la couleur de texte \fIcouleur_texte\fP et la couleur de fond \fIcouleur_fond\fP, -l'une de ces deux couleurs au moins devant être définie. Les couleurs -acceptées par \fBnano\fP pour le texte et le fond sont\ : \fIwhite\fP +l'une de ces deux couleurs au moins devant être définie. Les couleurs +acceptées par \fBnano\fP pour le texte et le fond sont\ : \fIwhite\fP (blanc), \fIblack\fP (noir), \fIred\fP (rouge), \fIblue\fP (bleu), \fIgreen\fP (vert), \fIyellow\fP (jaune), \fImagenta\fP, et \fIcyan\fP. -Pour la couleur du texte, vous pouvez ajouter à ces couleurs le préfixe +Pour la couleur du texte, vous pouvez ajouter à ces couleurs le préfixe \fIbright\fP (lumineux) pour obtenir une couleur plus lumineuse. Si -votre terminal est capable de gérer la transparence, ne pas spécifier de -\fIcouleur_fond\fP indique à \fBnano\fP d'essayer d'utiliser un fond +votre terminal est capable de gérer la transparence, ne pas spécifier de +\fIcouleur_fond\fP indique à \fBnano\fP d'essayer d'utiliser un fond transparent. .TP .B icolor \fIcouleur_texte\fP[,\fIcouleur_fond\fP] "\fImotif\fP" ... -Comme ci-dessus, mais la recherche des motifs est effectuée sans tenir +Comme ci-dessus, mais la recherche des motifs est effectuée sans tenir compte de la casse. .TP -.B color \fIcouleur_texte\fP[,\fIcouleur_fond\fP] start="\fImotif_début\fP" end="\fImotif_fin\fP" -Affiche les expressions commençant par l'expression rationnelle étendue -\fImotif_début\fP et se terminant par l'expression rationnelle étendue +.B color \fIcouleur_texte\fP[,\fIcouleur_fond\fP] start="\fImotif_début\fP" end="\fImotif_fin\fP" +Affiche les expressions commençant par l'expression rationnelle étendue +\fImotif_début\fP et se terminant par l'expression rationnelle étendue \fImotif_fin\fP en utilisant la couleur de texte \fIcouleur_texte\fP et la couleur de fond \fIcouleur_fond\fP, l'une de ces deux couleurs au -moins devant être définie. Cela permet à la colorisation syntaxique de -s'étendre sur plusieurs lignes. Notez que toutes les occurrences -successives de \fImotif_début\fP après le \fImotif_début\fP initial -seront surlignées jusqu'à la prochaine instance de \fImotif_fin\fP. +moins devant être définie. Cela permet à la colorisation syntaxique de +s'étendre sur plusieurs lignes. Notez que toutes les occurrences +successives de \fImotif_début\fP après le \fImotif_début\fP initial +seront surlignées jusqu'à la prochaine instance de \fImotif_fin\fP. .TP -.B icolor \fIcouleur_texte\fP[,\fIcouleur_fond\fP] start="\fImotif_début\fP" end="\fImotif_fin\fP" -Comme ci-dessus, mais la recherche des motifs est effectuée sans tenir +.B icolor \fIcouleur_texte\fP[,\fIcouleur_fond\fP] start="\fImotif_début\fP" end="\fImotif_fin\fP" +Comme ci-dessus, mais la recherche des motifs est effectuée sans tenir compte de la casse. .TP .B include "\fIfichier_de_syntaxes\fP" Lit le fichier \fIfichier_de_syntaxes\fP contenant une liste -autosuffisante de définitions de syntaxes. Ce fichier ne doit contenir +autosuffisante de définitions de syntaxes. Ce fichier ne doit contenir que des commandes \fBsyntax\fP, \fBcolor\fP et \fBicolor\fP. .SH FICHIERS .TP .I $SYSCONFDIR/nanorc -Fichier de configuration général +Fichier de configuration général .TP .I ~/.nanorc Fichier de configuration personnel @@ -348,29 +348,29 @@ Fichier de configuration personnel .TP \fBnano\fP(1) .PP -\fI/usr/share/doc/nano/examples/nanorc.sample\fP (ou son équivalent sur -votre système) +\fI/usr/share/doc/nano/examples/nanorc.sample\fP (ou son équivalent sur +votre système) .SH AUTEUR Chris Allegretta et d'autres (voir les fichiers \fIAUTHORS\fP et \fITHANKS\fP pour plus d'information). Cette page de -manuel a été initialement rédigée par Jordi Mallach pour -le système Debian (mais elle peut être utilisée par d'autres). +manuel a été initialement rédigée par Jordi Mallach pour +le système Debian (mais elle peut être utilisée par d'autres). .SH TRADUCTION -Cette adaptation française a été réalisée par Jean-Philippe\ Guérard - le 29\ novembre\ 2007 à partir de +Cette adaptation française a été réalisée par Jean-Philippe\ Guérard + le 29\ novembre\ 2007 à partir de la version 1.56 du 11\ octobre\ 2007 de la page de manuel de nanorc -(pour la version 2.0.0 de nano). Cette page a été relue par Gérard +(pour la version 2.0.0 de nano). Cette page a été relue par Gérard Delafond. -Un maximum de soin a été apporté lors de l'élaboration de cette -traduction\ ; néanmoins, quelques imperfections peuvent subsister. Si -vous en rencontrez, que ce soit dans la version française ou dans la -version originale, n'hésitez pas à les signaler à l'auteur ou au +Un maximum de soin a été apporté lors de l'élaboration de cette +traduction\ ; néanmoins, quelques imperfections peuvent subsister. Si +vous en rencontrez, que ce soit dans la version française ou dans la +version originale, n'hésitez pas à les signaler à l'auteur ou au traducteur. -La version originale la plus à jour de ce document est toujours +La version originale la plus à jour de ce document est toujours consultable via la commande\ : LANGUAGE=en man nano diff --git a/doc/man/fr/nanorc.5.html b/doc/man/fr/nanorc.5.html index e438be8..092aaef 100644 --- a/doc/man/fr/nanorc.5.html +++ b/doc/man/fr/nanorc.5.html @@ -1,5 +1,5 @@ - - + + @@ -37,8 +37,8 @@

nanorc − -fichier de configuration de l’éditeur nano du -projet GNU

+fichier de configuration de l’éditeur +nano du projet GNU

DESCRIPTION @@ -46,29 +46,34 @@ projet GNU

Cette page de -manuel décrit brièvement le fichier de -configuration de l’éditeur nano GNU.

+manuel décrit brièvement le fichier +de configuration de l’éditeur nano +GNU.

nano est -un petit éditeur sympathique et libre, qui vise -à remplacer Pico, l’éditeur par -défaut du logiciel non libre Pine. nano ne se -contentant pas de copier l’interface et -l’ergonomie de Pico, il offre également -certaines fonctionnalités manquantes (ou -désactivées par défaut) de Pico. Ces -fonctionnalités sont, par exemple, les fonctions de -recherche et de remplacement et la possibilité de -sauter directement à une ligne et à une -colonne précise.

+un petit éditeur sympathique et libre, qui vise +à remplacer Pico, l’éditeur +par défaut du logiciel non libre Pine. +nano ne se contentant pas de copier l’interface +et l’ergonomie de Pico, il offre +également certaines +fonctionnalités manquantes (ou +désactivées par +défaut) de Pico. Ces +fonctionnalités sont, par exemple, les +fonctions de recherche et de remplacement et la +possibilité de sauter directement +à une ligne et à une colonne +précise.

Le fichier -nanorc contient les paramètres par -défaut de nano. Il ne doit pas être au -format DOS ou Mac. Lors de son démarrage, nano -commencera par lire le fichier de configuration -général SYSCONFDIR/nanorc, puis lira le -fichier de configuration personnel de l’utilisateur +nanorc contient les paramètres par +défaut de nano. Il ne doit pas +être au format DOS ou Mac. Lors de son +démarrage, nano commencera par lire le fichier +de configuration général +SYSCONFDIR/nanorc, puis lira le fichier de +configuration personnel de l’utilisateur ~/.nanorc.

OPTIONS @@ -77,38 +82,44 @@ fichier de configuration personnel de l’utilisateur

Le fichier de -configuration accepte une série de commandes -set (activer) et unset (désactiver), -qui permettent de définir le paramétrage de -nano au démarrage sans avoir à utiliser +configuration accepte une série de commandes +set (activer) et unset +(désactiver), qui permettent de +définir le paramétrage de nano au +démarrage sans avoir à utiliser d’options de ligne de commande. De plus, les mots clefs syntax (syntaxe), color (couleur) et -icolor (couleur insensible à la casse) sont -utilisés pour définir les règles de -colorisation pour différents motifs de texte. -nano lit une commande par ligne.

+icolor (couleur insensible à la casse) +sont utilisés pour définir les +règles de colorisation pour +différents motifs de texte. nano lit une +commande par ligne.

Les options du -fichier de configuration ont priorité sur les valeurs -par défaut utilisées par nano. Les options de -la ligne de commande sont prioritaires par rapport aux -options du fichier de configuration. Les options sont -désactivées (unset) par défaut, sauf -les options prenant un argument.

+fichier de configuration ont priorité sur les +valeurs par défaut utilisées par +nano. Les options de la ligne de commande sont prioritaires +par rapport aux options du fichier de configuration. Les +options sont désactivées (unset) +par défaut, sauf les options prenant un +argument.

Les apostrophes -(« ’ ») et les guillemets -droits (« " ») -présents dans des chaînes de caractères -utilisées comme paramètres n’ont pas -besoin d’être précédées -d’une barre oblique inversée -(« \ »). La chaîne sera -terminée par le dernier guillemet droit. Par exemple, -pour l’option brackets, -""’)>]}" correspondra -à ", ’, ), ->, ] et }.

+(« ’ Â») et +les guillemets droits +(« " Â») +présents dans des chaînes de +caractères utilisées comme +paramètres n’ont pas besoin +d’être +précédées d’une +barre oblique inversée +(« \ Â»). La +chaîne sera terminée par le dernier +guillemet droit. Par exemple, pour l’option +brackets, ""’)>]}" +correspondra à ", ’, +), >, ] et }.

Les commandes et arguments reconnus sont :
@@ -119,42 +130,45 @@ automatique.

set/unset backup

-

Crée des copies de -sécurité nommées +

Crée des copies de +sécurité nommées nom_du_fichier~.

set backupdir -répertoire

+répertoire

-

Définit le -répertoire utilisé par nano pour -enregistrer les copies de sécurité uniques, si -l’enregistrement de copies de sécurité -est activé.

+

Définit le +répertoire utilisé par nano +pour enregistrer les copies de +sécurité uniques, si +l’enregistrement de copies de +sécurité est +activé.

set/unset backwards

-

Par défaut, les -recherches se font vers l’arrière.

+

Par défaut, les +recherches se font vers l’arrière.

set/unset boldtext

-

Utilise des caractères -gras à la place de la vidéo inverse.

+

Utilise des +caractères gras à la place de la +vidéo inverse.

set brackets -chaîne

+chaîne

-

Définit les -caractères considérés comme des -crochets fermants lors de la justification des paragraphes. -Ces caractères ne doivent pas contenir -d’espaces. Seules les ponctuations terminales, -éventuellement suivies de crochets fermants, peuvent -terminer une phrase.

+

Définit les +caractères considérés +comme des crochets fermants lors de la justification des +paragraphes. Ces caractères ne doivent pas +contenir d’espaces. Seules les ponctuations +terminales, éventuellement suivies de crochets +fermants, peuvent terminer une phrase.

La valeur par -défaut de cette option est : +défaut de cette option est : ""’)>]}".

N.D.T. : @@ -164,64 +178,70 @@ pour plus d’informations.

set/unset casesensitive

-

Par défaut, les +

Par défaut, les recherches ne tiennent pas compte de la casse.

set/unset const

Affiche en permanence la -position du curseur dans la ligne d’état.

+position du curseur dans la ligne +d’état.

set/unset cut

-

Par défaut, coupe le -texte du curseur à la fin de la ligne, au lieu de -couper la ligne entière.

+

Par défaut, coupe +le texte du curseur à la fin de la ligne, au +lieu de couper la ligne entière.

set fill n

-

Passe automatiquement à -la ligne une fois arrivé à la colonne -n. Si la valeur indiquée est de 0 ou moins, le -point de passage à la ligne aura lieu à la -taille de l’écran moins n. Cela permet -de faire varier le point de passage à la ligne -lorsque l’on change la taille de l’écran. -La valeur par défaut est de −8.

+

Passe automatiquement +à la ligne une fois arrivé +à la colonne n. Si la valeur +indiquée est de 0 ou moins, le point de passage +à la ligne aura lieu à la taille +de l’écran moins n. Cela permet de +faire varier le point de passage à la ligne +lorsque l’on change la taille de +l’écran. La valeur par +défaut est de −8.

set/unset historylog

Active l’utilisation de ~/.nano_history pour enregistrer et relire les -chaînes ayant fait l’objet d’une recherche -ou d’un remplacement.

+chaînes ayant fait l’objet d’une +recherche ou d’un remplacement.

set matchbrackets -chaîne

+chaîne

-

Définit les crochets -ouvrants et fermant pour la recherche de crochets +

Définit les +crochets ouvrants et fermant pour la recherche de crochets correspondants. Cette liste ne doit pas contenir de blancs. -L’ensemble des crochets ouvrants doit être -indiqué en premier, suivi de l’ensemble des -crochets fermant, qui doit être dans le même -ordre. La valeur par défaut de cette option est +L’ensemble des crochets ouvrants doit +être indiqué en premier, suivi de +l’ensemble des crochets fermant, qui doit +être dans le même ordre. La valeur +par défaut de cette option est "(<[{)>]}".

set/unset morespace

Utiliser la ligne blanche -située sous la ligne de titre comme espace -supplémentaire d’édition.

+située sous la ligne de titre comme espace +supplémentaire +d’édition.

set/unset mouse

Active l’utilisation de -la souris, si elle est disponible pour votre système. -Lorsque celle-ci est activée, il est possible -d’utiliser la souris pour positionner le curseur, pour -marquer le texte (avec un double-clic) et pour lancer les -fonctions correspondant aux raccourcis. Il est possible +la souris, si elle est disponible pour votre +système. Lorsque celle-ci est +activée, il est possible d’utiliser la +souris pour positionner le curseur, pour marquer le texte +(avec un double-clic) et pour lancer les fonctions +correspondant aux raccourcis. Il est possible d’utiliser la souris sous X Window ou en mode console avec gpm.

@@ -239,155 +259,168 @@ formats DOS et Mac.

set/unset nofollow

Ne suit pas les liens -symboliques lors de l’écriture des +symboliques lors de l’écriture des fichiers.

set/unset nohelp

-

Désactive les lignes -d’aide affichée en bas de -l’écran.

+

Désactive les +lignes d’aide affichée en bas de +l’écran.

set/unset nonewlines

Ne pas ajouter de passage -à la ligne à la fin des fichiers.

+à la ligne à la fin des +fichiers.

set/unset nowrap

-

Désactive le passage -automatique à la ligne.

+

Désactive le +passage automatique à la ligne.

set operatingdir -répertoire

+répertoire

nano ne lira et -n’écrira des fichiers qu’à -l’intérieur du répertoire et de -ses sous-répertoires. De plus, celui-ci devient le -répertoire courant, afin que les fichiers soient lus -depuis ce répertoire. Par défaut, cette -fonction est désactivée.

+n’écrira des fichiers +qu’à l’intérieur du +répertoire et de ses +sous-répertoires. De plus, celui-ci devient le +répertoire courant, afin que les fichiers +soient lus depuis ce répertoire. Par +défaut, cette fonction est +désactivée.

set/unset preserve

-

Préserve les -séquences XON et XOFF (^Q et ^S).

+

Préserve les +séquences XON et XOFF (^Q et ^S).

set punct -chaîne

- -

Définit les -caractères interprétés comme des -ponctuations terminales lors de la justification des -paragraphes. Ces caractères ne peuvent inclure de -blancs. Seules les ponctuations terminales, -éventuellement suivies de crochets fermants, peuvent -terminer une phrase. La valeur par défaut de cette -option est "!.?".

+chaîne

+ +

Définit les +caractères interprétés +comme des ponctuations terminales lors de la justification +des paragraphes. Ces caractères ne peuvent +inclure de blancs. Seules les ponctuations terminales, +éventuellement suivies de crochets fermants, +peuvent terminer une phrase. La valeur par +défaut de cette option est +"!.?".

N.D.T. : -ce réglage permet, lors de la justification, de -conserver 2 espaces au lieu d’une derrière -les ponctuations terminales, ce qui correspond aux normes -typographiques anglo-saxonnes, mais n’a pas lieu -d’être en français. Pour le -français, le plus simple est d’indiquer, dans -le fichier nanorc, une chaîne vide pour ce -paramètre.

+ce réglage permet, lors de la justification, de +conserver 2 espaces au lieu d’une +derrière les ponctuations terminales, ce qui +correspond aux normes typographiques anglo-saxonnes, mais +n’a pas lieu d’être en +français. Pour le français, le +plus simple est d’indiquer, dans le fichier nanorc, +une chaîne vide pour ce +paramètre.

set/unset quickblank

Effacement rapide de la ligne -d’état. Les messages affichés par la -ligne d’état disparaîtront après -une frappe clavier au lieu de 25.

+d’état. Les messages +affichés par la ligne d’état +disparaîtront après une frappe +clavier au lieu de 25.

set quotestr -chaîne

+chaîne

-

Définit le -préfixe par défaut utilisé pour les -citations dans les courriers électroniques. Ce -préfixe est utilisé pour réaliser une +

Définit le +préfixe par défaut +utilisé pour les citations dans les courriers +électroniques. Ce préfixe est +utilisé pour réaliser une justification correcte de ces citations. Il s’agira, -si votre système le permet, d’une expression -rationnelle étendue. Dans le cas contraire, il -s’agira d’une chaîne de texte brut. Si -vous disposez des expressions rationnelles, la valeur par -défaut de cette option sera -"^([ \t]*[#:>\|}])+", sinon, ce -sera "> ". Notez que le -« \t » ci-dessus correspond à -un caractère de tabulation.

+si votre système le permet, d’une +expression rationnelle étendue. Dans le cas +contraire, il s’agira d’une chaîne +de texte brut. Si vous disposez des expressions +rationnelles, la valeur par défaut de cette +option sera "^([ \t]*[#:>\|}])+", +sinon, ce sera "> ". Notez que le +« \t Â» ci-dessus +correspond à un caractère de +tabulation.

set/unset rebinddelete

-

Interprète -différemment la touche -« Supprimer », afin que les touches -« Effacement arrière » et -« Supprimer » fonctionnent -correctement. Vous ne devriez avoir besoin de cette option -que si, sur votre système, la touche -« Effacement arrière » produit -l’effet de la touche «  -Supprimer ».

+

Interprète +différemment la touche +« Supprimer Â», afin que +les touches « Effacement +arrière Â» et +« Supprimer Â» +fonctionnent correctement. Vous ne devriez avoir besoin de +cette option que si, sur votre système, la +touche « Effacement +arrière Â» produit +l’effet de la touche «  +Supprimer Â».

set/unset rebindkeypad

-

Interprète les touches -du pavé numérique afin qu’elles -fonctionnent toutes correctement. Vous ne devriez utiliser -cette option que si ce n’est pas le cas, car nano ne -sera plus capable d’utiliser la souris correctement -lorsque cette option sera activée.

+

Interprète les +touches du pavé numérique afin +qu’elles fonctionnent toutes correctement. Vous ne +devriez utiliser cette option que si ce n’est pas le +cas, car nano ne sera plus capable d’utiliser la +souris correctement lorsque cette option sera +activée.

set/unset regexp

-

Utilise par défaut des -expressions rationnelles étendues pour les +

Utilise par défaut +des expressions rationnelles étendues pour les recherches.

set/unset smarthome

Rend plus malin le fonctionnement de la touche -« Début ». Lorsque cette touche -est pressée à n’importe quel endroit -excepté au tout début du texte d’une -ligne (i. e. au premier caractère non blanc), le -curseur se positionnera au début du texte de la ligne -(qu’il soit en avant ou en arrière). Si le -curseur est déjà là, il se placera au -vrai début de la ligne.

+« Début Â». +Lorsque cette touche est pressée à +n’importe quel endroit excepté au tout +début du texte d’une ligne (i. e. au +premier caractère non blanc), le curseur se +positionnera au début du texte de la ligne +(qu’il soit en avant ou en arrière). Si le +curseur est déjà là, +il se placera au vrai début de la ligne.

set/unset smooth

-

Active le défilement -ligne-par-ligne du texte.

+

Active le +défilement ligne-par-ligne du texte.

set speller programme

Utilise le correcteur orthographique programme au lieu du correcteur -intégré, qui s’appuie sur +intégré, qui s’appuie sur spell.

set/unset suspend

-

Autorise à suspendre -nano.

+

Autorise à +suspendre nano.

set tabsize n

Utilise une taille de tabulation de n colonnes. Cette valeur doit -être strictement supérieure à 0. La -valeur par défaut est de 8.

+être strictement supérieure +à 0. La valeur par défaut est +de 8.

set/unset tabstospaces

@@ -397,10 +430,10 @@ clavier en espaces.

set/unset tempfile

-

S’il a été -modifié, le fichier sera sauvegardé -automatiquement en quittant, sans demande de -confirmation.

+

S’il a +été modifié, le +fichier sera sauvegardé automatiquement en +quittant, sans demande de confirmation.

set/unset view

@@ -408,112 +441,119 @@ confirmation.

fichiers.

set whitespace -chaîne

+chaîne

-

Définit les deux -caractères utilisés pour afficher les premiers -caractères des tabulations et des espaces. Ces deux -caractères doivent être mono-colonne.

+

Définit les deux +caractères utilisés pour afficher +les premiers caractères des tabulations et des +espaces. Ces deux caractères doivent +être mono-colonne.

set/unset wordbounds

-

Détection plus -précise des limites de mots, obtenue en -considérant les caractères de ponctuation -comme faisant partie des mots.

+

Détection plus +précise des limites de mots, obtenue en +considérant les caractères de +ponctuation comme faisant partie des mots.

syntax -chaîne +chaîne ["motif_de_fichier" ... ]

-

Définit une syntaxe -nommée chaîne qui pourra être -activé via l’option -Y (ou ---syntax) ou qui sera automatiquement activée -si le nom du fichier en cours correspond à -l’expression rationnelle étendue -motif_de_fichier. Toutes les instructions suivantes -de colorisation color ou icolor -s’appliqueront à cette syntaxe, -jusqu’à la définition d’une -nouvelle syntaxe.

+

Définit une +syntaxe nommée chaîne qui +pourra être activé via +l’option -Y (ou --syntax) ou qui sera +automatiquement activée si le nom du fichier en +cours correspond à l’expression +rationnelle étendue motif_de_fichier. +Toutes les instructions suivantes de colorisation +color ou icolor s’appliqueront +à cette syntaxe, jusqu’à la +définition d’une nouvelle syntaxe.

La syntaxe -nommée none (aucune) est -réservée ; si elle est indiquée -dans la ligne de commande, cela revient à ne -définir aucune syntaxe. La syntaxe nommée -default (par défaut) est spéciale, elle -ne nécessite aucun motif de motif_de_fichier, -et s’applique aux fichiers ne correspondant à -aucun des motif_de_fichier des autres syntaxes.

+nommée none (aucune) est +réservée ; si elle est +indiquée dans la ligne de commande, cela +revient à ne définir aucune +syntaxe. La syntaxe nommée default (par +défaut) est spéciale, elle ne +nécessite aucun motif de +motif_de_fichier, et s’applique aux fichiers ne +correspondant à aucun des +motif_de_fichier des autres syntaxes.

color couleur_texte[,couleur_fond] motif ...

Pour la syntaxe en cours, -affiche toutes les expressions correspondant à -l’expression rationnelle étendue motif -en utilisant la couleur de texte couleur_texte et la -couleur de fond couleur_fond, l’une de ces deux -couleurs au moins devant être définie. Les -couleurs acceptées par nano pour le texte et -le fond sont : white (blanc), black -(noir), red (rouge), blue (bleu), green -(vert), yellow (jaune), magenta, et -cyan. Pour la couleur du texte, vous pouvez ajouter -à ces couleurs le préfixe bright -(lumineux) pour obtenir une couleur plus lumineuse. Si votre -terminal est capable de gérer la transparence, ne pas -spécifier de couleur_fond indique à -nano d’essayer d’utiliser un fond -transparent.

+affiche toutes les expressions correspondant à +l’expression rationnelle étendue +motif en utilisant la couleur de texte +couleur_texte et la couleur de fond +couleur_fond, l’une de ces deux couleurs au +moins devant être définie. Les +couleurs acceptées par nano pour le +texte et le fond sont : white (blanc), +black (noir), red (rouge), blue (bleu), +green (vert), yellow (jaune), magenta, +et cyan. Pour la couleur du texte, vous pouvez +ajouter à ces couleurs le préfixe +bright (lumineux) pour obtenir une couleur plus +lumineuse. Si votre terminal est capable de +gérer la transparence, ne pas +spécifier de couleur_fond indique +à nano d’essayer d’utiliser +un fond transparent.

icolor couleur_texte[,couleur_fond] motif ...

Comme ci-dessus, mais la -recherche des motifs est effectuée sans tenir compte -de la casse.

+recherche des motifs est effectuée sans tenir +compte de la casse.

color couleur_texte[,couleur_fond] -start="motif_début" +start="motif_début" end="motif_fin"

Affiche les expressions -commençant par l’expression rationnelle -étendue motif_début et se terminant par -l’expression rationnelle étendue -motif_fin en utilisant la couleur de texte -couleur_texte et la couleur de fond +commençant par l’expression rationnelle +étendue motif_début et se +terminant par l’expression rationnelle +étendue motif_fin en utilisant la +couleur de texte couleur_texte et la couleur de fond couleur_fond, l’une de ces deux couleurs au -moins devant être définie. Cela permet à -la colorisation syntaxique de s’étendre sur -plusieurs lignes. Notez que toutes les occurrences -successives de motif_début après le -motif_début initial seront surlignées -jusqu’à la prochaine instance de -motif_fin.

+moins devant être définie. Cela +permet à la colorisation syntaxique de +s’étendre sur plusieurs lignes. Notez que +toutes les occurrences successives de +motif_début après le +motif_début initial seront +surlignées jusqu’à la +prochaine instance de motif_fin.

icolor couleur_texte[,couleur_fond] -start="motif_début" +start="motif_début" +
end="motif_fin"

Comme ci-dessus, mais la -recherche des motifs est effectuée sans tenir compte -de la casse.

+recherche des motifs est effectuée sans tenir +compte de la casse.

include fichier_de_syntaxes

Lit le fichier fichier_de_syntaxes contenant une liste -autosuffisante de définitions de syntaxes. Ce fichier -ne doit contenir que des commandes syntax, +autosuffisante de définitions de syntaxes. Ce +fichier ne doit contenir que des commandes syntax, color et icolor.

FICHIERS @@ -525,7 +565,7 @@ ne doit contenir que des commandes syntax,

$SYSCONFDIR/nanorc

Fichier de configuration -général

+général

~/.nanorc

@@ -540,7 +580,7 @@ personnel

nano(1)
/usr/share/doc/nano/examples/nanorc.sample (ou son -équivalent sur votre système)

+équivalent sur votre système)

AUTEUR @@ -551,9 +591,10 @@ personnel

Allegretta <chrisa@asty.org> et d’autres (voir les fichiers AUTHORS et THANKS pour plus d’information). Cette page de manuel a -été initialement rédigée par -Jordi Mallach <jordi@gnu.org> pour le système -Debian (mais elle peut être utilisée par +été initialement +rédigée par Jordi Mallach +<jordi@gnu.org> pour le système Debian +(mais elle peut être utilisée par d’autres).

TRADUCTION @@ -562,26 +603,30 @@ d’autres).

Cette -adaptation française a été -réalisée par Jean-Philippe Guérard +adaptation française a +été +réalisée par +Jean-Philippe Guérard <jean-philippe.guerard@tigreraye.org> le -29 novembre 2007 à partir de la version -1.56 du 11 octobre 2007 de la page de manuel de -nanorc (pour la version 2.0.0 de nano). Cette page a -été relue par Gérard Delafond.

+29 novembre 2007 à partir de la +version 1.56 du 11 octobre 2007 de la page de +manuel de nanorc (pour la version 2.0.0 de nano). Cette page +a été relue par +Gérard Delafond.

Un maximum de -soin a été apporté lors de -l’élaboration de cette traduction ; -néanmoins, quelques imperfections peuvent subsister. -Si vous en rencontrez, que ce soit dans la version -française ou dans la version originale, -n’hésitez pas à les signaler à -l’auteur ou au traducteur.

+soin a été apporté +lors de l’élaboration de cette +traduction ; néanmoins, quelques +imperfections peuvent subsister. Si vous en rencontrez, que +ce soit dans la version française ou dans la +version originale, n’hésitez pas +à les signaler à l’auteur ou +au traducteur.

La version -originale la plus à jour de ce document est toujours -consultable via la commande :

+originale la plus à jour de ce document est +toujours consultable via la commande :

LANGUAGE=en man nano

diff --git a/doc/man/fr/rnano.1 b/doc/man/fr/rnano.1 index 2f64367..70c06f8 100644 --- a/doc/man/fr/rnano.1 +++ b/doc/man/fr/rnano.1 @@ -3,13 +3,13 @@ .\" Skeleton based on nano-tiny.1: .\" Copyright (C) 2002 Free Software Foundation, Inc. .\" -.\" Le travail d'adaptation française de cette page de manuel a été -.\" réalisé par Jean-Philippe Guérard, en 2006 et 2007. Ce travail +.\" Le travail d'adaptation française de cette page de manuel a été +.\" réalisé par Jean-Philippe Guérard, en 2006 et 2007. Ce travail .\" d'adaptation est dans le domaine public. Attention, la page traduite .\" reste soumise au droit d'auteur de ses auteurs originaux. .\" .\" The French translation of this document is a public domain work of -.\" Jean-Philippe Guérard. This translation work was made in 2006 and +.\" Jean-Philippe Guérard. This translation work was made in 2006 and .\" 2007. The translated man page in itself is still subject to the .\" copyright of its original authors. .\" @@ -29,126 +29,126 @@ .\" Documentation License along with this program. If not, see .\" . .\" -.\" Ce document est publié sous une double licence. Vous pouvez +.\" Ce document est publié sous une double licence. Vous pouvez .\" le distribuer et le modifier selon les termes de l'une des deux -.\" licences ci-dessous : +.\" licences ci-dessous : .\" -.\" * La Licence publique générale GNU (GNU GPL) version 3 ou, à -.\" votre choix, supérieure, telle que publiée par la Free -.\" Software Foundation. Vous devriez avoir reçu une copie de la -.\" Licence publique générale GNU avec ce programme. Si ce n'est pas +.\" * La Licence publique générale GNU (GNU GPL) version 3 ou, à +.\" votre choix, supérieure, telle que publiée par la Free +.\" Software Foundation. Vous devriez avoir reçu une copie de la +.\" Licence publique générale GNU avec ce programme. Si ce n'est pas .\" le cas, consultez . .\" .\" * La Licence de documentation libre GNU (GNU FDL), version 1.2 ou, -.\" à votre choix, supérieure, telle que publiée par la Free +.\" à votre choix, supérieure, telle que publiée par la Free .\" Software Foundation, sans section invariante, ni texte de -.\" première ou de quatrième de couverture. Vous devriez avoir reçu +.\" première ou de quatrième de couverture. Vous devriez avoir reçu .\" une copie de la Licence de documentation libre GNU avec ce .\" programme. Si ce n'est pas le cas, consultez .\" . .\" -.\" $Id: rnano.1 4188 2007-12-08 04:27:44Z dolorous $ +.\" $Id: rnano.1 5071 2014-07-16 17:25:55Z jordi $ .TH RNANO 1 "version 2.0.0" "29\ novembre\ 20O7" .\" Please adjust this date whenever revising the manpage. -.\" Merci de modifier ces dates à chaque mise à jour de cette page. +.\" Merci de modifier ces dates à chaque mise à jour de cette page. .\" .SH NOM -rnano \- Le mode restreint de NAno un NOuvel éditeur, un clone libre et -amélioré de Pico +rnano \- Le mode restreint de NAno un NOuvel éditeur, un clone libre et +amélioré de Pico .SH SYNOPSIS .B rnano -.I [OPTIONS]\ [[\+LIGNE,COLONNE]\ FICHIER]... +.I [OPTIONS]\ [[+LIGNE,COLONNE]\ FICHIER]... .br .SH DESCRIPTION -Cette page de manuel décrit brièvement la commande \fBrnano\fR. +Cette page de manuel décrit brièvement la commande \fBrnano\fR. .PP .\" TeX users may be more comfortable with the \fB\fP and .\" \fI\fP escape sequences to invoke bold face and italics, .\" respectively. -\fBnano\fR est un éditeur petit, sympathique et libre, qui vise à -remplacer Pico, l'éditeur par défaut du logiciel non libre Pine. +\fBnano\fR est un éditeur petit, sympathique et libre, qui vise à +remplacer Pico, l'éditeur par défaut du logiciel non libre Pine. \fBnano\fR ne se contentant pas de copier l'interface et l'ergonomie de -Pico, il offre également certaines fonctions manquantes (ou désactivées -par défaut) dans Pico. Ces fonctionnalités sont, par exemple, les -fonctions de recherche et de remplacement, et la possibilité de sauter -directement à une ligne et à une colonne précise.. +Pico, il offre également certaines fonctions manquantes (ou désactivées +par défaut) dans Pico. Ces fonctionnalités sont, par exemple, les +fonctions de recherche et de remplacement, et la possibilité de sauter +directement à une ligne et à une colonne précise.. .PP \fBrnano\fP est une version de \fBnano\fP fonctionnant en mode -restreint, qui ne permet d'éditer que les fichiers indiqués et qui -n'autorise pas l'utilisateur à accéder au système de fichier ou à un -interpréteur de commandes. +restreint, qui ne permet d'éditer que les fichiers indiqués et qui +n'autorise pas l'utilisateur à accéder au système de fichier ou à un +interpréteur de commandes. .PP En mode restreint, \fBnano\fP refusera\ : .IP \[bu] 2 -de lire ou d'écrire dans un fichier n'ayant pas été indiqué dans la +de lire ou d'écrire dans un fichier n'ayant pas été indiqué dans la ligne de commande\ ; .IP \[bu] de lire un fichier nanorc\ ; .IP \[bu] -de permettre de suspendre l'édition\ ; +de permettre de suspendre l'édition\ ; .IP \[bu] -de permettre d'ajouter en début ou en fin d'un fichier, ou de -l'enregistrer sous un nom différent\ ; +de permettre d'ajouter en début ou en fin d'un fichier, ou de +l'enregistrer sous un nom différent\ ; .IP \[bu] -l'utilisation de copies de sécurité ou de la correction orthographique. +l'utilisation de copies de sécurité ou de la correction orthographique. .SH OPTIONS .TP -.B \+\fILIGNE\fP,\fICOLONNE\fP -Démarre avec le curseur positionné à la colonne \fICOLONNE\fP de -la ligne \fILIGNE\fR (l'un des deux, au moins, devant être spécifié) au -lieu de démarrer à la colonne\ 1, ligne\ 1. +.B +\fILIGNE\fP,\fICOLONNE\fP +Démarre avec le curseur positionné à la colonne \fICOLONNE\fP de +la ligne \fILIGNE\fR (l'un des deux, au moins, devant être spécifié) au +lieu de démarrer à la colonne\ 1, ligne\ 1. .TP .B \-? -Identique à \fB-h (\-\-help)\fP. +Identique à \fB\-h (\-\-help)\fP. .TP .B \-h (\-\-help) -Affiche un résumé des options de lancement de nano, puis s'arrête. +Affiche un résumé des options de lancement de nano, puis s'arrête. .TP .B \-V (\-\-version) -Affiche la version, puis s'arrête. +Affiche la version, puis s'arrête. .PP -Reportez-vous à la page de manuel \fBnano\fP(1) si vous souhaitez -consulter la documentation complète de \fBnano\fP. +Reportez-vous à la page de manuel \fBnano\fP(1) si vous souhaitez +consulter la documentation complète de \fBnano\fP. .SH BOGUES Merci de nous faire parvenir vos commentaires et de nous signaler les -bogues, en écrivant, en anglais, à \fBnano@nano-editor.org\fR. +bogues, en écrivant, en anglais, à \fBnano@nano-editor.org\fR. -La liste de discussion anglophone \fBnano\fR est disponible à l'adresse +La liste de discussion anglophone \fBnano\fR est disponible à l'adresse \fBnano-devel@gnu.org\fR. -Pour vous abonner, envoyez un courrier électronique à -\fBnano-devel-request@gnu.org\fR, ayant pour objet «\ subscribe\ ». +Pour vous abonner, envoyez un courrier électronique à +\fBnano-devel-request@gnu.org\fR, ayant pour objet «\ subscribe\ ». -N'hésitez pas également à envoyez vos commentaires, suggestions et -corrections relatives à l'adaptation française de cette page de manuel -ou du logiciel à \fBjean-philippe.guerard@tigreraye.org\fR. +N'hésitez pas également à envoyez vos commentaires, suggestions et +corrections relatives à l'adaptation française de cette page de manuel +ou du logiciel à \fBjean-philippe.guerard@tigreraye.org\fR. .SH "SITE INTERNET" http://www.nano-editor.org/ .SH AUTEUR Chris Allegretta et d'autres (voir le fichier -\fIAUTHORS\fR). Cette page de manuel a été initialement rédigée par -Thijs Kinkhorst , pour le système GNU Debian (mais -elle peut être utilisée par d'autres). +\fIAUTHORS\fR). Cette page de manuel a été initialement rédigée par +Thijs Kinkhorst , pour le système GNU Debian (mais +elle peut être utilisée par d'autres). .SH TRADUCTION -Cette adaptation française a été réalisée par Jean-Philippe\ Guérard - le 29\ novembre\ 2007 à partir +Cette adaptation française a été réalisée par Jean-Philippe\ Guérard + le 29\ novembre\ 2007 à partir de la version 1.19 du 6\ novembre\ 2007 de la page de manuel de rnano (pour la version 2.0.0 de nano). -Un maximum de soin a été apporté lors de l'élaboration de cette -traduction\ ; néanmoins, quelques imperfections peuvent subsister. Si -vous en rencontrez, que ce soit dans la version française ou dans la -version originale, n'hésitez pas à les signaler à l'auteur ou au +Un maximum de soin a été apporté lors de l'élaboration de cette +traduction\ ; néanmoins, quelques imperfections peuvent subsister. Si +vous en rencontrez, que ce soit dans la version française ou dans la +version originale, n'hésitez pas à les signaler à l'auteur ou au traducteur. -La version originale la plus à jour de ce document est toujours +La version originale la plus à jour de ce document est toujours consultable via la commande\ : LANGUAGE=en man nano diff --git a/doc/man/fr/rnano.1.html b/doc/man/fr/rnano.1.html index 26c2d1b..58d34fb 100644 --- a/doc/man/fr/rnano.1.html +++ b/doc/man/fr/rnano.1.html @@ -1,5 +1,5 @@ - - + + @@ -38,8 +38,9 @@

rnano − -Le mode restreint de NAno un NOuvel éditeur, un clone -libre et amélioré de Pico

+Le mode restreint de NAno un NOuvel éditeur, un +clone libre et amélioré de +Pico

SYNOPSIS @@ -55,29 +56,31 @@ libre et amélioré de Pico

Cette page de -manuel décrit brièvement la commande -rnano.

+manuel décrit brièvement la +commande rnano.

nano est -un éditeur petit, sympathique et libre, qui vise -à remplacer Pico, l’éditeur par -défaut du logiciel non libre Pine. nano ne se -contentant pas de copier l’interface et -l’ergonomie de Pico, il offre également -certaines fonctions manquantes (ou désactivées -par défaut) dans Pico. Ces fonctionnalités -sont, par exemple, les fonctions de recherche et de -remplacement, et la possibilité de sauter directement -à une ligne et à une colonne -précise..

+un éditeur petit, sympathique et libre, qui +vise à remplacer Pico, +l’éditeur par défaut du +logiciel non libre Pine. nano ne se contentant pas de +copier l’interface et l’ergonomie de Pico, il +offre également certaines fonctions manquantes +(ou désactivées par +défaut) dans Pico. Ces +fonctionnalités sont, par exemple, les +fonctions de recherche et de remplacement, et la +possibilité de sauter directement +à une ligne et à une colonne +précise..

rnano est une version de nano fonctionnant en mode -restreint, qui ne permet d’éditer que les -fichiers indiqués et qui n’autorise pas -l’utilisateur à accéder au -système de fichier ou à un interpréteur -de commandes.

+restreint, qui ne permet d’éditer que les +fichiers indiqués et qui n’autorise pas +l’utilisateur à accéder au +système de fichier ou à un +interpréteur de commandes.

En mode restreint, nano refusera :

@@ -94,9 +97,9 @@ restreint, nano refusera :

-

de lire ou d’écrire dans un fichier -n’ayant pas été indiqué dans la -ligne de commande ;

+

de lire ou d’écrire dans un fichier +n’ayant pas été +indiqué dans la ligne de commande ;

@@ -119,7 +122,7 @@ ligne de commande ;

de permettre de suspendre -l’édition ;

+l’édition ;

@@ -130,9 +133,9 @@ l’édition ;

-

de permettre d’ajouter en début ou en fin -d’un fichier, ou de l’enregistrer sous un nom -différent ;

+

de permettre d’ajouter en début ou en +fin d’un fichier, ou de l’enregistrer sous un +nom différent ;

@@ -143,8 +146,9 @@ différent ;

-

l’utilisation de copies de sécurité -ou de la correction orthographique.

+

l’utilisation de copies de +sécurité ou de la correction +orthographique.

OPTIONS @@ -155,11 +159,12 @@ ou de la correction orthographique.

+LIGNE,COLONNE

-

Démarre avec le curseur -positionné à la colonne COLONNE de la -ligne LIGNE (l’un des deux, au moins, devant -être spécifié) au lieu de -démarrer à la colonne 1, +

Démarre avec le +curseur positionné à la colonne +COLONNE de la ligne LIGNE (l’un des +deux, au moins, devant être +spécifié) au lieu de +démarrer à la colonne 1, ligne 1.

−?

- - +
+ -

Identique à -h (−−help).

 +

Identique à −h +(−−help).

−h (−−help)

-

Affiche un résumé -des options de lancement de nano, puis -s’arrête.

+

Affiche un +résumé des options de lancement de +nano, puis s’arrête.

−V (−−version)

Affiche la version, puis -s’arrête.

+s’arrête.

Reportez-vous -à la page de manuel nano(1) si vous souhaitez -consulter la documentation complète de +à la page de manuel nano(1) si vous +souhaitez consulter la documentation complète de nano.

BOGUES @@ -204,24 +210,25 @@ consulter la documentation complète de

Merci de nous faire parvenir vos commentaires et de nous signaler les -bogues, en écrivant, en anglais, à +bogues, en écrivant, en anglais, à nano@nano-editor.org.

La liste de -discussion anglophone nano est disponible à -l’adresse nano-devel@gnu.org.

+discussion anglophone nano est disponible +à l’adresse +nano-devel@gnu.org.

Pour vous -abonner, envoyez un courrier électronique à -nano-devel-request@gnu.org, ayant pour objet -« subscribe ».

+abonner, envoyez un courrier électronique +à nano-devel-request@gnu.org, ayant pour +objet « subscribe Â».

-

N’hésitez -pas également à envoyez vos commentaires, -suggestions et corrections relatives à -l’adaptation française de cette page de manuel -ou du logiciel à +

N’hésitez +pas également à envoyez vos +commentaires, suggestions et corrections relatives +à l’adaptation française de +cette page de manuel ou du logiciel à jean-philippe.guerard@tigreraye.org.

SITE INTERNET @@ -240,10 +247,11 @@ ou du logiciel à

Chris Allegretta <chrisa@asty.org> et d’autres (voir le fichier AUTHORS). Cette page de manuel a -été initialement rédigée par -Thijs Kinkhorst <thijs@kinkhorst.com>, pour le -système GNU Debian (mais elle peut être -utilisée par d’autres).

+été initialement +rédigée par Thijs Kinkhorst +<thijs@kinkhorst.com>, pour le système GNU +Debian (mais elle peut être +utilisée par d’autres).

TRADUCTION @@ -251,25 +259,28 @@ utilisée par d’autres).

Cette -adaptation française a été -réalisée par Jean-Philippe Guérard +adaptation française a +été +réalisée par +Jean-Philippe Guérard <jean-philippe.guerard@tigreraye.org> le -29 novembre 2007 à partir de la version -1.19 du 6 novembre 2007 de la page de manuel de -rnano (pour la version 2.0.0 de nano).

+29 novembre 2007 à partir de la +version 1.19 du 6 novembre 2007 de la page de +manuel de rnano (pour la version 2.0.0 de nano).

Un maximum de -soin a été apporté lors de -l’élaboration de cette traduction ; -néanmoins, quelques imperfections peuvent subsister. -Si vous en rencontrez, que ce soit dans la version -française ou dans la version originale, -n’hésitez pas à les signaler à -l’auteur ou au traducteur.

+soin a été apporté +lors de l’élaboration de cette +traduction ; néanmoins, quelques +imperfections peuvent subsister. Si vous en rencontrez, que +ce soit dans la version française ou dans la +version originale, n’hésitez pas +à les signaler à l’auteur ou +au traducteur.

La version -originale la plus à jour de ce document est toujours -consultable via la commande :

+originale la plus à jour de ce document est +toujours consultable via la commande :

LANGUAGE=en man nano

diff --git a/doc/man/nano.1 b/doc/man/nano.1 index 6921431..63ec8ec 100644 --- a/doc/man/nano.1 +++ b/doc/man/nano.1 @@ -1,6 +1,8 @@ .\" Hey, EMACS: -*- nroff -*- +.\" $Id: nano.1 5135 2015-03-08 15:59:15Z bens $ +.\" .\" 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 +20,7 @@ .\" Documentation License along with this program. If not, see .\" . .\" -.\" $Id: nano.1 4502 2010-04-14 21:55:39Z astyanax $ -.TH NANO 1 "version 2.2.0" "November 30, 2009" +.TH NANO 1 "version 2.4.0" "March 2015" .\" Please adjust this date whenever revising the manpage. .\" @@ -28,203 +29,212 @@ nano \- Nano's ANOther editor, an enhanced free Pico clone .SH SYNOPSIS .B nano -.I [OPTIONS]\ [[\+LINE,COLUMN]\ FILE]... -.br +.RI [ options "] [[+" line , column "]\ " file "]..." .SH DESCRIPTION -This manual page briefly documents the \fBnano\fP command. -.PP -.\" TeX users may be more comfortable with the \fB\fP and -.\" \fI\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. +default line 1, column 1. .TP -.B \-? -Same as \fB-h (\-\-help)\fP. -.TP -.B \-A (\-\-smarthome) +.BR \-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. .TP -.B \-B (\-\-backup) +.BR \-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 +.BR \-C\ \fIdirectory\fR ", " \-\-backupdir= \fIdirectory +Set the directory where \fBnano\fP puts unique backup files, if file backups are enabled. .TP -.B \-D (\-\-boldtext) +.BR \-D ", " \-\-boldtext Use bold text instead of reverse video text. .TP -.B \-E (\-\-tabstospaces) +.BR \-E ", " \-\-tabstospaces Convert typed tabs to spaces. .TP -.B \-F (\-\-multibuffer) -Enable multiple file buffers, if available. +.BR \-F ", " \-\-multibuffer +Enable multiple file buffers (if support for them has been compiled in). +.TP +.BR \-G ", " \-\-locking +Enable vim-style file locking when editing files. .TP -.B \-H (\-\-historylog) -Log search and replace strings to \fI~/.nano_history\fP, so they can be -retrieved in later sessions, if \fInanorc\fP support is available. +.BR \-H ", " \-\-historylog +Log search and replace strings to \fI~/.nano/search_history\fP, so they can be +retrieved in later sessions. .TP -.B \-I (\-\-ignorercfiles) -Don't look at \fISYSCONFDIR/nanorc\fP or \fI~/.nanorc\fP, if -\fInanorc\fP support is available. +.BR \-I ", " \-\-ignorercfiles +Don't look at the system's \fBnanorc\fP nor at \fB~/.nanorc\fP. .TP -.B \-K (\-\-rebindkeypad) +.BR \-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. .TP -.B \-L (\-\-nonewlines) +.BR \-L ", " \-\-nonewlines Don't add newlines to the ends of files. .TP -.B \-N (\-\-noconvert) +.BR \-N ", " \-\-noconvert Disable automatic conversion of files from DOS/Mac format. .TP -.B \-O (\-\-morespace) +.BR \-O ", " \-\-morespace Use the blank line below the titlebar as extra editing space. .TP -.B \-Q \fIstr\fP (\-\-quotestr=\fIstr\fP) +.BR \-P ", " \-\-poslog +Log and later read back the location of the cursor and place it there +again. +.TP +.BR "\-Q ""\fIcharacters\fB""" ", " "\-\-quotestr=""" \fIcharacters\fR """ Set the quoting string for justifying. The default is -"\fI^([\ \\t]*[#:>\\|}])+\fP" if extended regular expression support is -available, or "\fI>\ \fP" otherwise. Note that \fI\\t\fP stands for a +\fB"^([\ \\t]*[#:>\\|}])+"\fP if extended regular expression support is +available, or \fB">\ "\fP otherwise. Note that \fB\\t\fP stands for a Tab. .TP -.B \-R (\-\-restricted) +.BR \-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"). -.TP -.B \-S (\-\-smooth) +command line; don't read any \fInanorc\fP files nor history files; +don't allow suspending nor spell checking; +don't allow a file to be appended to, prepended to, or saved under a +different name if it already has one; and don't use backup files. +This restricted mode is also accessible by invoking \fBnano\fP +with any name beginning with 'r' (e.g. "rnano"). +.TP +.BR \-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. +.BR \-T\ \fInumber\fR ", " \-\-tabsize= \fInumber +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) +.BR \-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) +.BR \-V ", " \-\-version Show the current version number and exit. .TP -.B \-W (\-\-wordbounds) +.BR \-W ", " \-\-wordbounds Detect word boundaries more accurately by treating punctuation characters as part of a word. .TP -.B \-Y \fIstr\fP (\-\-syntax=\fIstr\fP) -Specify a specific syntax highlighting from the \fInanorc\fP to use, if -available. +.BR \-Y\ \fIname\fR ", " \-\-syntax= \fIname +Specify the name of the syntax highlighting to use from among the ones +defined in the \fInanorc\fP files. .TP -.B \-c (\-\-const) -Constantly show the cursor position. Note that this overrides \fB-U\fP. +.BR \-c ", " \-\-const +Constantly show the cursor position. Note that this overrides \fB\-U\fP. .TP -.B \-d (\-\-rebinddelete) +.BR \-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. .TP -.B \-h (\-\-help) -Show a summary of command line options and exit. +.BR \-h ", " \-\-help +Show a summary of the available command-line options and exit. .TP -.B \-i (\-\-autoindent) +.BR \-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. +.BR \-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. .TP -.B \-l (\-\-nofollow) +.BR \-l ", " \-\-nofollow If the file being edited is a symbolic link, replace the link with a new file instead of following it. Good for editing files in \fI/tmp\fP, perhaps? .TP -.B \-m (\-\-mouse) +.BR \-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. +System, and on the console when gpm is running. Text can still be +selected through dragging by holding down the Shift key. .TP -.B \-o \fIdir\fP (\-\-operatingdir=\fIdir\fP) -Set operating directory. Makes \fBnano\fP set up something similar to a -chroot. +.BR \-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 \-p (\-\-preserve) +.BR \-o\ \fIdirectory\fR ", " \-\-operatingdir= \fIdirectory +Set the operating directory. This makes \fBnano\fP set up something +similar to a chroot. +.TP +.BR \-p ", " \-\-preserve 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 +.BR \-q ", " \-\-quiet +Do not report errors in the \fInanorc\fP files 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 +.BR \-r\ \fInumber\fR ", " \-\-fill= \fInumber +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) -Enable alternative spell checker command. +.BR \-s\ \fIprogram\fR ", " \-\-speller= \fIprogram +Use this alternative spell checker command. .TP -.B \-t (\-\-tempfile) -Always save changed buffer without prompting. Same as Pico's \fB-t\fP +.BR \-t ", " \-\-tempfile +Always save a 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. -.TP -.B \-v (\-\-view) -View file (read only) mode. +.BR \-v ", " \-\-view +View-file (read-only) mode. .TP -.B \-w (\-\-nowrap) -Disable wrapping of long lines. +.BR \-w ", " \-\-nowrap +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. +.BR \-x ", " \-\-nohelp +Don't show the two help lines at the bottom of the screen. .TP -.B \-z (\-\-suspend) -Enable suspend ability. +.BR \-z ", " \-\-suspend +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 +.BR \-$ ", " \-\-softwrap +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 \-$'). +this option last when using other options (e.g.\& 'nano \-wS$') or pass it +separately (e.g.\& 'nano \-wS \-$'). .TP -.B \-a, \-b, \-e, \-f, \-g, \-j +.BR \-a ", " \-b ", " \-e ", " \-f ", " \-g ", " \-j Ignored, for compatibility with Pico. .SH INITIALIZATION FILE \fBnano\fP will read initialization files in the following order: -\fISYSCONFDIR/nanorc\fP, then \fI~/.nanorc\fP. Please see -\fBnanorc(5)\fP and the example file \fBnanorc.sample\fP, both of which -should be provided with \fBnano\fP. +the system's \fBnanorc\fP (if it exists), and then the user's +\fB~/.nanorc\fP (if it exists). Please see +.BR nanorc (5) +for more information on the possible contents of those files. .SH NOTES If no alternative spell checker command is specified on the command -line or in one of the \fInanorc\fP files, \fBnano\fP will check the +line nor in one of the \fInanorc\fP files, \fBnano\fP will check the \fBSPELL\fP environment variable for one. In some cases \fBnano\fP will try to dump the buffer into an emergency @@ -233,7 +243,7 @@ SIGTERM or runs out of memory. It will write the buffer into a file named \fInano.save\fP if the buffer didn't have a name already, or will add a ".save" suffix to the current filename. If an emergency file with that name already exists in the current directory, it will add ".save" -plus a number (e.g. ".save.1") to the current filename in order to make +plus a number (e.g.\& ".save.1") to the current filename in order to make it unique. In multibuffer mode, \fBnano\fP will write all the open buffers to their respective emergency files. @@ -256,7 +266,7 @@ http://www.nano-editor.org/ \fI/usr/share/doc/nano/\fP (or equivalent on your system) .SH AUTHOR -Chris Allegretta , et al (see \fIAUTHORS\fP and +Chris Allegretta , et al (see the files \fIAUTHORS\fP and \fITHANKS\fP for details). This manual page was originally written by Jordi Mallach , for the Debian system (but may be used by others). diff --git a/doc/man/nano.1.html b/doc/man/nano.1.html index cb1101e..bd7b43f 100644 --- a/doc/man/nano.1.html +++ b/doc/man/nano.1.html @@ -1,5 +1,5 @@ - - + + @@ -48,22 +48,20 @@ Nano’s ANOther editor, an enhanced free Pico clone

nano -[OPTIONS] [[+LINE,COLUMN] FILE]...

+[options] +[[+line,column] file]...

DESCRIPTION

-

This manual -page briefly documents the nano command.

-

nano 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, nano 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, +nano also implements some missing (or disabled by +default) features in Pico, such as "search and replace" and "go to line and column number".

@@ -73,32 +71,15 @@ number".

-

+LINE,COLUMN

- -

Places cursor at line number -LINE and column number COLUMN (at least one of -which must be specified) on startup, instead of the default -of line 1, column 1.

- - - - - - - - -
- - -

−?

 +

+line,column

+

Places the cursor on line +number line and at column number column (at +least one of which must be specified) on startup, instead of +the default line 1, column 1.

-

Same as -h (−−help).

 -
- -

−A -(−−smarthome)

+

−A, +−−smarthome

Make the Home key smarter. When Home is pressed anywhere but at the very beginning of @@ -107,277 +88,309 @@ that beginning (either forwards or backwards). 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 ~.

+a tilde (~).

+ -

−C dir -(−−backupdir=dir)

+

−C directory, +−−backupdir=directory

Set the directory where -nano puts unique backup files if file backups are +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 support for them has been compiled in).

-

Enable multiple file buffers, -if available.

+

−G, +−−locking

-

−H -(−−historylog)

+

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.

+to ~/.nano/search_history, so they can be retrieved +in later sessions.

-

−I -(−−ignorercfiles)

+

−I, +−−ignorercfiles

-

Don’t look at -SYSCONFDIR/nanorc or ~/.nanorc, if -nanorc support is available.

+

Don’t look at the +system’s nanorc nor at ~/.nanorc.

-

−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)

+

−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 +"characters", +−−quotestr="characters"

Set the quoting string for justifying. The default is -"^([ \t]*[#:>\|}])+" if extended +"^([ \t]*[#:>\|}])+" if extended regular expression support is available, or -"> " otherwise. Note that \t +"> " otherwise. Note that \t stands for a Tab.

-

−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").

+don’t read any nanorc files nor history files; +don’t allow suspending nor spell checking; don’t +allow a file to be appended to, prepended to, or saved under +a different name if it already has one; and don’t use +backup files. This restricted mode is also accessible by +invoking nano with any name beginning with +’r’ (e.g. "rnano").

-

−S -(−−smooth)

+

−S, +−−smooth

Enable smooth scrolling. Text will scroll line-by-line, instead of the usual chunk-by-chunk behavior.

-

−T cols -(−−tabsize=cols)

+ +

−T number, +−−tabsize=number

Set the size (width) of a tab -to cols columns. The value of cols must be +to number columns. The value of number must be greater than 0. The default value is 8.

-

−U -(−−quickblank)

+

−U, +−−quickblank

Do quick statusbar blanking. Statusbar messages will disappear after 1 keystroke instead -of 25. Note that -c overrides this.

+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 part of a word.

-

−Y str -(−−syntax=str)

-

Specify a specific syntax -highlighting from the nanorc to use, if -available.

+

−Y name, +−−syntax=name

+ +

Specify the name of the syntax +highlighting to use from among the ones defined in the +nanorc files.

-

−c -(−−const)

+

−c, +−−const

Constantly show the cursor -position. Note that this overrides -U.

+position. 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)

+

−h, +−−help

-

Show a summary of command line -options and exit.

+

Show a summary of the available +command-line options and exit.

-

−i -(−−autoindent)

+

−i, +−−autoindent

Indent new lines to the previous line’s indentation. Useful when editing source code.

-

−k -(−−cut)

+

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

-

−l -(−−nofollow)

+

−l, +−−nofollow

If the file being edited is a symbolic link, replace the link with a new file instead of following it. Good for editing files in /tmp, perhaps?

-

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

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

+

−o directory, +−−operatingdir=directory

-

−p -(−−preserve)

+

Set the operating directory. +This makes nano set up something similar to a +chroot.

+ +

−p, +−−preserve

Preserve the XON and XOFF sequences (^Q and ^S) so they will be caught by the terminal.

-

−q -(−−quiet)

+

−q, +−−quiet

Do not report errors in the -nanorc file and ask them to be acknowledged by +nanorc files nor 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 columns, +

−r number, +−−fill=number

+ +

Hard-wrap lines at column +number. If this value is 0 or less, wrapping will +occur at the width of the screen less number columns, allowing the wrap point to vary along with the width of the screen if the screen is resized. The default value is -−8.

+−8. This option conflicts with −w -- the +last one given takes effect.

+ -

−s prog -(−−speller=prog)

+

−s program, +−−speller=program

-

Enable alternative spell +

Use this alternative spell checker command.

-

−t -(−−tempfile)

+

−t, +−−tempfile

-

Always save changed buffer -without prompting. Same as Pico’s -t +

Always save a changed buffer +without prompting. Same as Pico’s −t option.

-

−u -(−−undo)

- -

Enable experimental -generic-purpose undo code. By default, the undo and redo -shortcuts are Meta-U and Meta-E, respectively.

- -

−v -(−−view)

+

−v, +−−view

-

View file (read only) mode.

+

View-file (read-only) mode.

-

−w -(−−nowrap)

+

−w, +−−nowrap

-

Disable wrapping of long -lines.

+

Disable the hard-wrapping of +long lines. This option conflicts with −r -- +the last one given takes effect.

-

−x -(−−nohelp)

+

−x, +−−nohelp

-

Disable help screen at bottom -of editor.

+

Don’t show the two help +lines at the bottom of the screen.

-

−z -(−−suspend)

+

−z, +−−suspend

-

Enable suspend ability.

+

Enable the suspend ability.

-

−$ -(−−softwrap)

+

−$, +−−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 +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.

@@ -388,10 +401,11 @@ Pico.

nano -will read initialization files in the following order: -SYSCONFDIR/nanorc, then ~/.nanorc. Please see -nanorc(5) and the example file nanorc.sample, -both of which should be provided with nano.

+will read initialization files in the following order: the +system’s nanorc (if it exists), and then the +user’s ~/.nanorc (if it exists). Please see +nanorc(5) for more information on the possible +contents of those files.

NOTES @@ -400,7 +414,7 @@ both of which should be provided with nano.

If no alternative spell checker command is specified on the -command line or in one of the nanorc files, +command line nor in one of the nanorc files, nano will check the SPELL environment variable for one.

@@ -458,7 +472,7 @@ email to nano-devel-request@gnu.org with a subject of

Chris -Allegretta <chrisa@asty.org>, et al (see +Allegretta <chrisa@asty.org>, et al (see the files AUTHORS and THANKS for details). This manual page was originally written by Jordi Mallach <jordi@gnu.org>, for the Debian system (but may be diff --git a/doc/man/nanorc.5 b/doc/man/nanorc.5 index 3c69209..c2c802d 100644 --- a/doc/man/nanorc.5 +++ b/doc/man/nanorc.5 @@ -1,6 +1,8 @@ .\" Hey, EMACS: -*- nroff -*- -.\" Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009 -.\" Free Software Foundation, Inc. +.\" $Id: nanorc.5 5135 2015-03-08 15:59:15Z bens $ +.\" +.\" Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, +.\" 2013, 2014, 2015 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,242 +20,296 @@ .\" Documentation License along with this program. If not, see .\" . .\" -.\" $Id: nanorc.5 4508 2010-06-21 03:10:10Z astyanax $ -.TH NANORC 5 "version 2.0.0" "August 23, 2007" +.TH NANORC 5 "version 2.4.0" "March 2015" .\" 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 \fB/etc/nanorc\fP (the exact path might be +different), 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. +.PP Options in \fInanorc\fP files take precedence over nano's defaults, and -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 +command-line options override \fInanorc\fP settings. Also, options that +do not take an argument are unset by default. So using the \fBunset\fR +command is only needed when wanting to override a setting of the system's +\fInanorc\fR file in your own \fB~/.nanorc\fR. Options that take an +argument cannot be unset. +.PP +Below, the \fIstring\fR parameters need to be enclosed in double quotes. +Quotes inside these 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. +.PP The supported commands and arguments are: .TP 3 -.B set/unset allow_insecure_backup +.B set 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 +can't be (re)set due to special OS considerations. You should NOT enable this option unless you are sure you need it. .TP -.B set/unset autoindent +.B set autoindent Use auto-indentation. .TP -.B set/unset backup -Create backup files in \fIfilename~\fP. +.B set backup +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 +.B set backwards Do backwards searches by default. .TP -.B set/unset boldtext -Use bold text instead of reverse video text. +.B set 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 \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. +.B set casesensitive +Do case-sensitive searches by default. .TP -.B set/unset const +.B set const Constantly display the cursor position in the status bar. .TP -.B set/unset cut -Use cut to end of line by default. +.B set cut +Use cut-to-end-of-line by default, instead of cutting the whole line. +.TP +.B set fill \fInumber\fR +Hard-wrap lines at column number \fInumber\fR. If \fInumber\fR is 0 or less, +the maximum line length will be the screen width less \fInumber\fP columns. +The default value is \fB\-8\fR. .TP -.B set fill \fIn\fP -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. +.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. +.B set historylog +Enable the use of \fB~/.nano/search_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 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 +.B set morespace Use the blank line below the titlebar as extra editing space. .TP -.B set/unset mouse +.B set 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. +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 +.B set multibuffer Allow inserting files into their own buffers. .TP -.B set/unset noconvert +.B set noconvert Don't convert files from DOS/Mac format. .TP -.B set/unset nofollow +.B set nofollow Don't follow symlinks when writing files. .TP -.B set/unset nohelp -Don't display the help lists at the bottom of the screen. +.B set nohelp +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. +.B set nonewlines +Don't automatically add a newline to the ends of files. .TP -.B set/unset nowrap -Don't wrap text at all. +.B set nowrap +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 subdirectories. Also, the current directory is changed to here, so -files are inserted from this diractory. By default, the operating +files are inserted from this directory. By default, the operating directory feature is turned off. .TP -.B set/unset preserve +.B set poslog +Save the cursor position of files between editing sessions. +.TP +.B set 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". +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 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. -.TP -.B set/unset quickblank +.B set quickblank Do quick statusbar blanking. Statusbar messages will disappear after 1 keystroke instead of 25. .TP +.B set 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 +.B set 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. .TP -.B set/unset rebindkeypad +.B set 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. .TP -.B set/unset regexp +.B set regexp Do extended regular expression searches by default. .TP -.B set/unset smarthome +.B set 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. .TP -.B set/unset smooth +.B set smooth Use smooth scrolling by default. .TP -.B set/unset softwrap -Enable soft line wrapping for easier viewing of very long lones. +.B set softwrap +Enable soft line wrapping for easier viewing of very long lines. .TP .B set speller "\fIspellprog\fP" Use spelling checker \fIspellprog\fP instead of the built-in one, which calls \fIspell\fP. .TP -.B set/unset suspend +.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 suspend Allow \fBnano\fP to be suspended. .TP -.B set tabsize \fIn\fP -Use a tab size of \fIn\fP columns. The value of \fIn\fP must be greater -than 0. The default value is 8. +.B set tabsize \fInumber\fR +Use a tab size of \fInumber\fR columns. The value of \fInumber\fP must be +greater than 0. The default value is \fB8\fR. .TP -.B set/unset tabstospaces +.B set tabstospaces Convert typed tabs to spaces. .TP -.B set/unset tempfile +.B set tempfile Save automatically on exit, don't prompt. .TP -.B set/unset undo -Enable experimental generic-purpose undo code. +.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 view +.B set 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 +.B set wordbounds Detect word boundaries more accurately by treating punctuation characters as parts of words. -.TP -.B syntax "\fIstr\fP" ["\fIfileregex\fP" ... ] + +.SH SYNTAX HIGHLIGHTING +Coloring the different syntactic elements of a file +is done via regular expressions (see the \fBcolor\fR command below). +This is inherently imperfect, because regular expressions are not +powerful enough to fully parse a file. Nevertheless, regular +expressions can do a lot and are easy to make, so they are a +good fit for a small editor like \fBnano\fR. +.sp +A separate syntax can be defined for each kind of file +via the following commands: +.TP +.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 color \fIfgcolor\fP,\fIbgcolor\fP "\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 +.BI formatter " program " \fR[ "arg " \fR...] +For the currently defined syntax, use the given \fIprogram\fR +to automatically reformat text. Useful in certain programming +languages (e.g. go). +.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 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\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, @@ -262,244 +318,322 @@ 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 -.B ^ +.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: +.RS 3 +.TP 3 +.B ^ followed by an alpha character or the word "Space". Example: ^C .TP -.B M- +.B M- followed by a printable character or the word "Space". Example: M-C .TP -.B F +.B F followed by a numeric value from 1 to 16. Example: F10 +.RE + .TP -Valid function names to be bound include: -.TP 3 +Valid \fIfunction\fP names to be bound include: +.RS 3 +.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 -- or for filenames matching +a string in the current list in the file browser. .TP .B searchagain -Repeat the last search command. +Repeats the last search command. .TP -.B up -Move up in the editor or browser. -.TP -.B down -Move down in the editor or browser. -.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 gototext +Switches from targeting a line number to searching for text. +.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. +Deletes the character under the cursor. .TP -.B fulljustify -Justify the entire current file. -.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. +.B flipreplace +Toggles between searching for something and replacing something. .TP -.B gototext -Search for files matching a string in the file browser (reading or writing files). +.B flipexecute +Toggles between inserting a file and executing a command. +.TP +.B flipnewbuffer +Toggles between inserting into the current buffer and into a new +empty buffer. +.TP +.B tofiles +Starts the file browser, allowing to select a file from a list. +.TP +.B gotodir +Goes to a directory to be specified, allowing to browse anywhere +in the filesystem. .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 suspendenable -Toggle whether the suspend sequence (normally ^Z) will suspend the editor window. +.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 support for them has been compiled in). .TP +.B mouse +Toggles mouse support. +.TP +.B noconvert +Toggles automatic conversion of files from DOS/Mac format. +.TP +.B suspendenable +Toggles whether the suspend sequence (normally ^Z) will suspend the editor window. +.RE -Valid menu sections are: .TP +Valid \fImenu\fP sections are: +.RS 3 +.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). @@ -520,14 +654,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 @@ -535,26 +672,22 @@ 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. +A special name that encompasses all menus. +For \fBbind\fR it means all menus where the specified \fIfunction\fR exists; +for \fBunbind\fR it means all menus where the specified \fIkey\fR exists. +.RE -.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 -System-wide configuration file +.B /etc/nanorc +System-wide configuration file. .TP -.I ~/.nanorc -Per-user configuration file +.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 94e2b6d..9f1ea5d 100644 --- a/doc/man/nanorc.5.html +++ b/doc/man/nanorc.5.html @@ -1,5 +1,5 @@ - - + + @@ -23,7 +23,8 @@ NAME
DESCRIPTION
OPTIONS
-KEY BINDINGS
+SYNTAX HIGHLIGHTING
+REBINDING KEYS
FILES
SEE ALSO
AUTHOR
@@ -44,24 +45,13 @@ GNU nano’s rcfile

-

This manual -page briefly documents GNU nano’s rcfile.

- -

nano 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, nano also implements some missing (or disabled -by default) features in Pico, such as "search and -replace" and "go to line and column -number".

-

The nanorc file contains the default settings for -nano. It 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.

+nano, a small and friendly editor. The file should be +in Unix format, not in DOS or Mac format. During startup, +nano will first read the system-wide settings, from +/etc/nanorc (the exact path might be different), and +then the user-specific settings, from ~/.nanorc.

OPTIONS @@ -71,150 +61,182 @@ user-specific settings from ~/.nanorc.

The configuration 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.

+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. +nano reads one command per line.

Options in nanorc files take precedence over nano’s -defaults, and command line options override nanorc -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 brackets -option, ""’)>]}" will match -", ’, ), >, -], and }.

+defaults, and command-line options override nanorc +settings. Also, options that do not take an argument are +unset by default. So using the unset command is only +needed when wanting to override a setting of the +system’s nanorc file in your own +~/.nanorc. Options that take an argument cannot be +unset.

+ +

Below, the +string parameters need to be enclosed in double +quotes. Quotes inside these 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, +""’)>]}" will match +", ’, ), >, +], and }.

The supported commands and arguments are:
-set/unset allow_insecure_backup

+set 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

+

set autoindent

Use auto-indentation.

-

set/unset backup

+

set backup

-

Create backup files in -filename~.

+

Create backup files by adding a +tilde (~) to each file’s name.

set backupdir directory

Set the directory where -nano puts unique backup files if file backups are +nano puts unique backup files, if file backups are enabled.

-

set/unset backwards

+

set backwards

Do backwards searches by default.

-

set/unset boldtext

+

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

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 -""’)>]}".

+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 +""’)>]}".

-

set/unset -casesensitive

+

set casesensitive

-

Do case sensitive searches by +

Do case-sensitive searches by default.

-

set/unset const

+

set const

Constantly display the cursor position in the status bar.

-

set/unset cut

+

set cut

-

Use cut to end of line by -default.

+

Use cut-to-end-of-line by +default, instead of cutting the whole line.

+ +

set fill +number

+ +

Hard-wrap lines at column +number number. If number is 0 or less, the +maximum line length will be the screen width less +number columns. The default value is +−8.

+ +

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 historylog

-

set fill n

+

Enable the use of +~/.nano/search_history for saving and reading +search/replace strings.

-

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 keycolor +fgcolor,bgcolor

-

set/unset historylog

+

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.

-

Enable ~/.nano_history -for saving and reading search/replace strings.

+

set 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 "(<[{)>]}".

+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 "(<[{)>]}".

-

set/unset morespace

+

set morespace

Use the blank line below the titlebar as extra editing space.

-

set/unset mouse

+

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

+Window System, and on the console when gpm is running. Text +can still be selected through dragging by holding down the +Shift key.

-

set/unset -multibuffer

+

set multibuffer

Allow inserting files into their own buffers.

-

set/unset noconvert

+

set noconvert

Don’t convert files from DOS/Mac format.

-

set/unset nofollow

+

set nofollow

Don’t follow symlinks when writing files.

-

set/unset nohelp

+

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

-

set/unset nonewlines

+

set nonewlines

-

Don’t add newlines to the -ends of files.

+

Don’t automatically add a +newline to the ends of files.

-

set/unset nowrap

+

set nowrap

-

Don’t wrap text at +

Don’t hard-wrap text at all.

set operatingdir @@ -223,10 +245,15 @@ all.

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 diractory. By default, the operating +inserted from this directory. By default, the operating directory feature is turned off.

-

set/unset preserve

+

set poslog

+ +

Save the cursor position of +files between editing sessions.

+ +

set preserve

Preserve the XON and XOFF keys (^Q and ^S).

@@ -235,25 +262,26 @@ directory feature is turned off.

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 "!.?".

- -

set/unset quiet

- -

nano will not report -errors in the nanorc 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.

+closing punctuation when justifying paragraphs. This may not +include blank characters. Only the specfified closing +punctuation, optionally followed by closing brackets (see +brackets), can end sentences. The default value is +"!.?".

-

set/unset quickblank

+

set quickblank

Do quick statusbar blanking. Statusbar messages will disappear after 1 keystroke instead of 25.

+

set quiet

+ +

nano will not report +errors in the nanorc 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.

+

set quotestr string

@@ -261,33 +289,31 @@ of 25.

justify email-quoted paragraphs. This is an extended regular expression if your system supports them, otherwise a literal string. The default value is -"^([ \t]*[#:>\|}])+" if you have -extended regular expression support, or -"> " otherwise. Note that +"^([ \t]*[#:>\|}])+" if you have +extended regular expression support, and +"> " otherwise. Note that ’\t’ stands for a literal Tab character.

-

set/unset -rebinddelete

+

set 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 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 regexp

Do extended regular expression searches by default.

-

set/unset smarthome

+

set smarthome

Make the Home key smarter. When Home is pressed anywhere but at the very beginning of @@ -296,15 +322,15 @@ that beginning (either forwards or backwards). If the cursor is already at that position, it will jump to the true beginning of the line.

-

set/unset smooth

+

set smooth

Use smooth scrolling by default.

-

set/unset softwrap

+

set softwrap

Enable soft line wrapping for -easier viewing of very long lones.

+easier viewing of very long lines.

set speller spellprog

@@ -313,100 +339,161 @@ easier viewing of very long lones.

spellprog instead of the built-in one, which calls spell.

-

set/unset suspend

+

set statuscolor +fgcolor,bgcolor

+ +

Specify the color combination +to use for the statusbar. See set titlecolor for more +details.

+ +

set suspend

Allow nano to be suspended.

-

set tabsize n

+

set tabsize +number

-

Use a tab size of n -columns. The value of n must be greater than 0. The -default value is 8.

+

Use a tab size of number +columns. The value of number must be greater than 0. +The default value is 8.

-

set/unset -tabstospaces

+

set tabstospaces

Convert typed tabs to spaces.

-

set/unset tempfile

+

set tempfile

Save automatically on exit, don’t prompt.

-

set/unset undo

+

set titlecolor +fgcolor,bgcolor

-

Enable experimental -generic-purpose undo code.

+

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 view

+

set view

Disallow file modification.

-

set/unset softwrap

- -

Enable soft line wrapping for -easier viewing of very long lones.

-

set whitespace string

Set the two characters used to -display the first characters of tabs and spaces. They must -be single-column characters.

+indicate the presence of tabs and spaces. They must be +single-column characters.

-

set/unset wordbounds

+

set wordbounds

Detect word boundaries more accurately by treating punctuation characters as parts of words.

-

syntax str -["fileregex" ... ]

+

SYNTAX HIGHLIGHTING + +

-

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.

-

The none +

Coloring the +different syntactic elements of a file is done via regular +expressions (see the color command below). This is +inherently imperfect, because regular expressions are not +powerful enough to fully parse a file. Nevertheless, regular +expressions can do a lot and are easy to make, so they are a +good fit for a small editor like nano.

+ +

A separate +syntax can be defined for each kind of file via the +following commands:
+syntax "str" +["fileregex" ...]

+ +

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.

+ +

The none syntax is reserved; specifying it on the command line is the -same as not having a syntax at all. The default +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).

+ +

formatter program +[arg ...]

+ +

For the currently defined +syntax, use the given program to automatically +reformat text. Useful in certain programming languages (e.g. +go).

+ +

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

+fgcolor,bgcolor "regex" +...

-

For the currently defined +

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.

+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 nano to attempt to use a +transparent background.

icolor -fgcolor,bgcolor regex ...

+fgcolor,bgcolor "regex" +...

-

Same as above, except that the +

Same as above, except that the expression matching is case insensitive.

color -fgcolor,bgcolor -start="sr" -end="er"

+fgcolor,bgcolor +start="sr" +end="er"

-

Display expressions which start +

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 @@ -417,23 +504,34 @@ is found will be highlighted until the first instance of er.

icolor -fgcolor,bgcolor -start="sr" -end="er"

+fgcolor,bgcolor +start="sr" +end="er"

-

Same as above, except that the +

Same as above, except that the expression matching is case insensitive.

include -syntaxfile

+"syntaxfile"

-

Read in self-contained color +

Read in self-contained color syntaxes from syntaxfile. Note that syntaxfile -can only contain syntax, color, and -icolor commands.

- -

KEY BINDINGS - +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. This +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).

+ +

REBINDING KEYS +

@@ -443,481 +541,568 @@ bind key function menu

Rebinds the key key to a new function named function in the context of menu -menu. The format of key should be one of:

+menu (or in all menus where the function exists by +using all).

+ +

unbind key +menu

+ +

Unbinds the key key from +the menu named 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 function names to be -bound include:
-help

- -

Invoke the help menu.

+

Valid function names to +be bound include:

-

cancel

+

help

-

Cancel the current command.

+

Invokes the help viewer.

-

exit

+

cancel

-

Exit from the program.

+

Cancels the current +command.

-

writeout

+

exit

-

Write the current buffer to -disk.

+

Exits from the program (or from +the help viewer or the file browser).

-

justify

+

writeout

-

Justify the current text.

+

Writes the current buffer to +disk.

-

insert

+

insert

-

Insert a file into the current +

Inserts a file into the current buffer (or into a new buffer when multibuffer is enabled).

-

whereis

+

whereis

-

Search for text in the current -buffer.

+

Searches for text in the +current buffer -- or for filenames matching a string in the +current list in the file browser.

-

searchagain

+

searchagain

-

Repeat the last search +

Repeats the last search command.

- - - - - - - -
+

replace

+

Interactively replaces text +within the current buffer.

-

up

 +

cut

+

Cuts and stores the current +line (or the marked region).

-

Move up in the editor or browser.

 -
+

copytext

-

down

+

Copies the current line (or the +marked region) without deleting it.

-

Move down in the editor or -browser.

+

uncut

-

left

+

Copies the currently stored +text into the current buffer at the current cursor +position.

-

Move left in the editor or -browser.

+

mark

-

right

+

Sets the mark at the current +position, to start selecting text.

-

Move right in the editor or -browser.

+

cutrestoffile

-

cut

+

Cuts all text from the cursor +position till the end of the buffer.

-

Cut the current line of text -and store it.

+

curpos

-

uncut

+

Shows the current cursor +position: the line, column, and character positions.

-

Copy the currently stored text -into the current buffer position.

+

wordcount

-

curpos

+

Counts the number of words, +lines and characters in the current buffer.

-

Show the current line, column, -word positions in the file.

+

speller

-

firstline

+

Invokes a spell-checking +program (or a linting program, if the current syntax +highlighting defines one).

-

Move to the first line of the -file.

+

justify

-

lastline

+

Justifies the current +paragraph.

-

Move to the last line of the -file.

+

fulljustify

-

gotoline

+

Justifies the entire current +buffer.

-

Move to a specific line (and -column if specified).

+

indent

-

replace

+

Indents (shifts to the right) +the currently marked text.

-

Interactively replace text -within the current buffer.

+

unindent

+ +

Unindents (shifts to the left) +the currently marked text.

+ +

left

-

mark

+

Goes left one position (in the +editor or browser).

-

Begin selecting text for -cutting or pasting at the current position.

+

right

-

copytext

+

Goes right one position (in the +editor or browser).

-

Copy the currently marked text -without deleting it.

+

up

-

indent

+

Goes one line up (in the editor +or browser).

-

Indent the currently marked -text (shift to the right).

+

down

-

unindent

+

Goes one line down (in the +editor or browser).

-

Un-indent the currently marked -text (shift to the left).

+

scrollup

-

nextword

+

Scrolls up one line of text +from the current position.

+ +

scrolldown

+ +

Scrolls down one line of text +from the current position.

-

Move the cursor to the +

nextword

+ +

Moves the cursor to the beginning of the next word.

-

prevword

+

prevword

-

Move the cursor to the +

Moves the cursor to the beginning of the previous word.

-

home

+

home

-

Move the cursor to the +

Moves the cursor to the beginning of the current line.

-

end

+

end

-

Move the cursor to the end of +

Moves the cursor to the end of the current line.

-

beginpara

+

beginpara

-

Move the cursor to the +

Moves the cursor to the beginning of the current paragraph.

-

endpara

+

endpara

-

Move the cursor to the end of +

Moves the cursor to the end of the current paragraph.

-

findbracket

+

prevpage

-

Move the cursor to the matching -bracket (brace, parenthesis, etc.) of the one under the -cursor.

+

Goes up one screenful.

-

scrollup

+

nextpage

-

Scroll up one line of text from -the current position.

+

Goes down one screenful.

-

scrolldown

+

firstline

-

Scroll down one line of text -from the current position.

+

Goes to the first line of the +file.

+ +

lastline

+ +

Goes to the last line of the +file.

-

prevbuf

+

gotoline

-

Switch to editing/viewing the +

Goes to a specific line (and +column if specified).

+ +

gototext

+ +

Switches from targeting a line +number to searching for text.

+ +

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

+

nextbuf

-

Switch to editing/viewing the +

Switches to editing/viewing the next buffer when using multibuffer mode.

-

verbatim

+

verbatim

-

Insert the next character +

Inserts the next character verbatim into the file.

-

tab

+

tab

-

Insert a tab at the current +

Inserts a tab at the current cursor location.

-

enter

+

enter

-

Insert a new line below the +

Inserts a new line below the current one.

-

delete

+

delete

-

Delete the character under the +

Deletes the character under the cursor.

-

fulljustify

+

backspace

-

Justify the entire current -file.

+

Deletes the character before +the cursor.

-

wordcount

+

undo

-

Count the number of words in -the current buffer.

+

Undoes the last performed text +action (add text, delete text, etc).

-

refresh

+

redo

-

Refresh the screen.

+

Redoes the last undone action +(i.e., it undoes an undo).

-

undo

+

refresh

-

Undo the text action peformed -(add text, delete text, etc).

+

Refreshes the screen.

-

redo

+

suspend

-

Redo the last undone action -(i.e., undo an undo).

- -

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

-

casesens

+

casesens

-

Toggle case sensitivity in +

Toggles case sensitivity in searching (search/replace menus only).

-

regexp

+

regexp

-

Toggle whether +

Toggles whether searching/replacing is based on literal strings or regular expressions.

-

prevhistory

+

backwards

+ +

Toggles whether +searching/replacing goes forward or backward.

+ +

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

-

nexthistory

+

nexthistory

-

Show the next history entry in +

Shows the next history entry in the prompt menus (e.g. search).

-

dontreplace

+

flipreplace

+ +

Toggles between searching for +something and replacing something.

+ +

flipexecute

+ +

Toggles between inserting a +file and executing a command.

-

Switch back to searching -instead of replacing.

+

flipnewbuffer

-

gototext

+

Toggles between inserting into +the current buffer and into a new empty buffer.

-

Search for files matching a -string in the file browser (reading or writing files).

+

tofiles

-

dosformat

+

Starts the file browser, +allowing to select a file from a list.

-

When writing a file, switch to -writing a DOS format (CR/LF).

+

gotodir

-

macformat

+

Goes to a directory to be +specified, allowing to browse anywhere in the +filesystem.

-

When writing a file, switch to -writing a Mac format.

+

dosformat

-

append

+

When writing a file, switches +to writing a DOS format (CR/LF).

-

When writing a file, append to +

macformat

+ +

When writing a file, switches +to writing a Mac format.

+ +

append

+ +

When writing a file, appends to the end instead of overwriting.

-

prepend

+

prepend

-

When writing a file, -’prepend’ (write at the beginning) instead of +

When writing a file, +’prepends’ (writes at the beginning) instead of overwriting.

-

backup

+

backup

-

When writing a file, create a +

When writing a file, creates a backup of the current file.

-

firstfile

+

firstfile

-

Move to the first file when +

Goes to the first file when using the file browser (reading or writing files).

-

lastfile

+

lastfile

-

Move to the last file when +

Goes to the last file when using the file browser (reading or writing files).

-

nohelp

+

nohelp

-

Toggle showing/hiding the +

Toggles the presence of the two-line list of key bindings at the bottom of the screen.

-

constupdate

+

constupdate

+ +

Toggles the constant display of +the current line, column, and character positions.

-

Constantly display the current -line, column, word positions.

+

morespace

-

morespace

+

Toggles the presence of the +blank line which ’separates’ the titlebar from +the file text.

-

Toggle showing/hiding the blank -line which ’separates’ the ’title’ -from the file text.

+

smoothscroll

-

smoothscroll

+

Toggles smooth scrolling (when +moving around with the arrow keys).

-

Toggle smooth scrolling when -moving via the arrow keys.

+

softwrap

-

whitespacedisplay

+

Toggles the displaying of +overlong lines on multiple screen lines.

-

Toggle whether whitespace is -shown.

+

whitespacedisplay

-

smarthome

+

Toggles the showing of +whitespace.

-

Toggle whether the smart home -key function is enabled.

+

nosyntax

-

autoindent

+

Toggles syntax +highlighting.

-

Toggle whether new lines will -contain the same amount of whitespace as the line above.

+

smarthome

-

cuttoend

+

Toggles the smartness of the +Home key.

-

Toggle whether cutting text +

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

+

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 support for them has been compiled in).

+ +

mouse

-

Toggle whether long lines will -be wrapped to the next line.

+

Toggles mouse support.

-

suspendenable

+

noconvert

-

Toggle whether the suspend +

Toggles automatic conversion of +files from DOS/Mac format.

+ +

suspendenable

+ +

Toggles whether the suspend sequence (normally ^Z) will suspend the editor window.

-

Valid menu -sections are:
-main

+

Valid menu sections +are:

-

The main editor window where -text is entered.

+

main

-

search

+

The main editor window where +text is entered and edited.

-

The search menu (AKA +

search

+ +

The search menu (AKA whereis).

-

replace

+

replace

-

The ’search to +

The ’search to replace’ menu.

-

replacewith

+

replacewith

-

The ’replace with’ +

The ’replace with’ menu, which comes up after ’search to replace’.

-

gotoline

+

gotoline

-

The ’goto line (and +

The ’goto line (and column)’ menu.

-

writeout

+

writeout

-

The ’write file’ +

The ’write file’ menu.

-

insert

+

insert

-

The ’insert file’ +

The ’insert file’ menu.

-

extcmd

+

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.

-

help

+

help

-

The help menu.

+

The help-viewer menu.

-

spell

+

spell

-

The interactive spell checker +

The interactive spell checker Yes/no menu.

-

browser

+

linter

+ +

The linter menu.

-

The file browser for inserting +

browser

+ +

The file browser for inserting or writing a file.

-

whereisfile

+

whereisfile

-

The ’search for a +

The ’search for a file’ menu in the file browser.

-

gotodir

- -

The ’go to -directory’ menu.

+

gotodir

-

all

+

The ’go to +directory’ menu in the file browser.

-

A special name meaning: apply -to all menus where this function exists.

+

all

-

unbind key -menu

- -

Unbind the key key from -the menu named menu or from all menus by using -all. Same key syntax as for binding. Rebinds the key -key to a new function named function in the -context of menu menu. The format of key should -be one of:

+

A special name that encompasses +all menus. For bind it means all menus where the +specified function exists; for unbind it means +all menus where the specified key exists.

FILES @@ -925,35 +1110,39 @@ be one of:

-

SYSCONFDIR/nanorc

+

/etc/nanorc

System-wide configuration -file

+file.

-

~/.nanorc

+

~/.nanorc

-

Per-user configuration file

+

Per-user configuration +file.

SEE ALSO

-

nano(1) -
-/usr/share/doc/nano/examples/nanorc.sample (or -equivalent on your system)

+ +

nano(1)

+ + +

/usr/share/doc/nano/examples/nanorc.sample +(or equivalent on your system)

AUTHOR

-

Chris Allegretta -<chrisa@asty.org>, et al (see AUTHORS and -THANKS for details). This manual page was originally -written by Jordi Mallach <jordi@gnu.org>, for the -Debian system (but may be used by others).

+

Chris +Allegretta <chrisa@asty.org>, et al (see +AUTHORS and THANKS for details). This manual +page was originally written by Jordi Mallach +<jordi@gnu.org>, for the Debian system (but may be +used by others).

diff --git a/doc/man/rnano.1 b/doc/man/rnano.1 index 6b8a9b8..24851b2 100644 --- a/doc/man/rnano.1 +++ b/doc/man/rnano.1 @@ -1,7 +1,7 @@ .\" Hey, EMACS: -*- nroff -*- -.\" Copyright (C) 2005, 2006, 2007 Free Software Foundation, Inc. -.\" Skeleton based on nano-tiny.1: -.\" Copyright (C) 2002 Free Software Foundation, Inc. +.\" $Id: rnano.1 5135 2015-03-08 15:59:15Z bens $ +.\" +.\" Copyright (C) 2002, 2005, 2006, 2007, 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: @@ -19,8 +19,7 @@ .\" Documentation License along with this program. If not, see .\" . .\" -.\" $Id: rnano.1 4188 2007-12-08 04:27:44Z dolorous $ -.TH RNANO 1 "version 2.0.0" "August 23, 2007" +.TH RNANO 1 "version 2.4.0" "March 2015" .\" Please adjust this date whenever revising the manpage. .\" .SH NAME @@ -29,18 +28,12 @@ Pico clone .SH SYNOPSIS .B rnano -.I [OPTIONS]\ [[\+LINE,COLUMN]\ FILE]... -.br +.RI [ options "] [[+" line , column "]\ " file "]..." .SH DESCRIPTION -This manual page briefly documents the \fBrnano\fP command. -.PP -.\" TeX users may be more comfortable with the \fB\fP and -.\" \fI\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 @@ -48,7 +41,7 @@ replace" and "go to line and column number". specific files and doesn't allow the user access to the filesystem or a command shell. .PP -In restricted mode, \fBnano\fP will \fInot\fP: +In restricted mode, \fBnano\fP will \fInot\/\fP: .IP \[bu] 2 read or write to any file not specified on the command line; .IP \[bu] @@ -63,22 +56,13 @@ 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. +.BR \-h ", " \-\-help +Show a summary of command-line options and exit. .TP -.B \-V (\-\-version) +.BR \-V ", " \-\-version Show the current version number and exit. .PP -See the \fBnano\fP(1) manpage for the complete documentation of -\fBnano\fP. +See the \fBnano\fP(1) manpage for all of the possible options. .SH BUGS Please send any comments or bug reports to \fBnano@nano-editor.org\fP. @@ -92,7 +76,7 @@ of "subscribe". http://www.nano-editor.org/ .SH AUTHOR -Chris Allegretta , et al (see AUTHORS for details). +Chris Allegretta , et al (see the file AUTHORS for details). This manual page was originally written by Thijs Kinkhorst , for the Debian system (but may be used by others). diff --git a/doc/man/rnano.1.html b/doc/man/rnano.1.html index 5fc5991..0dd2db0 100644 --- a/doc/man/rnano.1.html +++ b/doc/man/rnano.1.html @@ -1,5 +1,5 @@ - - + + @@ -46,22 +46,20 @@ free Pico clone

rnano -[OPTIONS] [[+LINE,COLUMN] FILE]...

+[options] +[[+line,column] file]...

DESCRIPTION

-

This manual -page briefly documents the rnano command.

-

nano 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, nano 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, +nano also implements some missing (or disabled by +default) features in Pico, such as "search and replace" and "go to line and column number".

@@ -140,45 +138,20 @@ under a different name;

-

+LINE,COLUMN

- -

Places cursor at line number -LINE and column number COLUMN (at least one of -which must be specified) on startup, instead of the default -of line 1, column 1.

- - - - - - - - -
- - -

−?

 - - -

Same as -h (−−help).

 -
- -

−h -(−−help)

+

−h, +−−help

-

Show a summary of command line +

Show a summary of command-line options and exit.

-

−V -(−−version)

+

−V, +−−version

Show the current version number and exit.

See the -nano(1) manpage for the complete documentation of -nano.

+nano(1) manpage for all of the possible options.

BUGS @@ -210,10 +183,10 @@ email to nano-devel-request@gnu.org with a subject of

Chris -Allegretta <chrisa@asty.org>, et al (see AUTHORS for -details). This manual page was originally written by Thijs -Kinkhorst <thijs@kinkhorst.com>, for the Debian system -(but may be used by others).

+Allegretta <chrisa@asty.org>, et al (see the file +AUTHORS for details). This manual page was originally +written by Thijs Kinkhorst <thijs@kinkhorst.com>, for +the Debian system (but may be used by others).

diff --git a/doc/nanorc.sample.in b/doc/nanorc.sample.in index f164c26..911f2b9 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