From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id E61091381F3 for ; Wed, 4 Sep 2013 19:13:01 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 7ABD5E0DB9; Wed, 4 Sep 2013 19:13:01 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id CB5C2E1032 for ; Wed, 4 Sep 2013 19:13:00 +0000 (UTC) Received: from hornbill.gentoo.org (hornbill.gentoo.org [94.100.119.163]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id C1D6433EA58 for ; Wed, 4 Sep 2013 19:12:59 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by hornbill.gentoo.org (Postfix) with ESMTP id 6B483E468F for ; Wed, 4 Sep 2013 19:12:58 +0000 (UTC) From: "Ulrich Mueller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Mueller" Message-ID: <1378321927.cf86331609a3e82f99313edf70e2e18f90a56623.ulm@gentoo> Subject: [gentoo-commits] proj/emacs:master commit in: eclass/ X-VCS-Repository: proj/emacs X-VCS-Files: eclass/ChangeLog eclass/elisp-common.eclass X-VCS-Directories: eclass/ X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Mueller X-VCS-Revision: cf86331609a3e82f99313edf70e2e18f90a56623 X-VCS-Branch: master Date: Wed, 4 Sep 2013 19:12:58 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: 7cc79029-cd01-401f-8cdd-04787cd0ca49 X-Archives-Hash: 0113a0f480ea85080f777ed03ad6d230 commit: cf86331609a3e82f99313edf70e2e18f90a56623 Author: Ulrich Müller gentoo org> AuthorDate: Wed Sep 4 19:12:07 2013 +0000 Commit: Ulrich Mueller gentoo org> CommitDate: Wed Sep 4 19:12:07 2013 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=proj/emacs.git;a=commit;h=cf863316 Add proper @CODE tags in comments. --- eclass/ChangeLog | 3 +++ eclass/elisp-common.eclass | 46 +++++++++++++++++++++++++++++++--------------- 2 files changed, 34 insertions(+), 15 deletions(-) diff --git a/eclass/ChangeLog b/eclass/ChangeLog index 9495777..d443777 100644 --- a/eclass/ChangeLog +++ b/eclass/ChangeLog @@ -778,6 +778,9 @@ Copyright 2002-2012 Gentoo Foundation Distributed under the terms of the GNU General Public License v2 + 04 Sep 2013; Ulrich Müller elisp-common.eclass: + Add proper @CODE tags in comments. + 24 Aug 2012; Ulrich Müller elisp-common.eclass: Suppress warning for initial installation. diff --git a/eclass/elisp-common.eclass b/eclass/elisp-common.eclass index 4decc2c..8085e56 100644 --- a/eclass/elisp-common.eclass +++ b/eclass/elisp-common.eclass @@ -23,7 +23,9 @@ # # When relying on the emacs USE flag, you need to add # -# emacs? ( virtual/emacs ) +# @CODE +# emacs? ( virtual/emacs ) +# @CODE # # to your DEPEND/RDEPEND line and use the functions provided here to # bring the files to the correct locations. @@ -35,7 +37,9 @@ # tested with function elisp-need-emacs(), which would typically be # called from pkg_setup(), as in the following example: # -# elisp-need-emacs 23 || die "Emacs version too low" +# @CODE +# elisp-need-emacs 23 || die "Emacs version too low" +# @CODE # # Please note that such tests should be limited to packages that are # known to fail with lower Emacs versions; the standard case is to @@ -50,7 +54,9 @@ # directory is added to the load-path which makes sure that all files # are loadable. # -# elisp-compile *.el +# @CODE +# elisp-compile *.el +# @CODE # # Function elisp-make-autoload-file() can be used to generate a file # with autoload definitions for the lisp functions. It takes the output @@ -70,16 +76,20 @@ # choose something else, but remember to tell elisp-site-file-install() # (see below) the change, as it defaults to ${PN}. # -# elisp-install ${PN} *.el *.elc +# @CODE +# elisp-install ${PN} *.el *.elc +# @CODE # # To let the Emacs support be activated by Emacs on startup, you need # to provide a site file (shipped in ${FILESDIR}) which contains the # startup code (have a look in the documentation of your software). # Normally this would look like this: # -# (add-to-list 'load-path "@SITELISP@") -# (add-to-list 'auto-mode-alist '("\\.csv\\'" . csv-mode)) -# (autoload 'csv-mode "csv-mode" "Major mode for csv files." t) +# @CODE +# (add-to-list 'load-path "@SITELISP@") +# (add-to-list 'auto-mode-alist '("\\.csv\\'" . csv-mode)) +# (autoload 'csv-mode "csv-mode" "Major mode for csv files." t) +# @CODE # # If your Emacs support files are installed in a subdirectory of # /usr/share/emacs/site-lisp/ (which is strongly recommended), you need @@ -108,11 +118,15 @@ # Best practice is to define a SITEFILE variable in the global scope of # your ebuild (e.g., right after S or RDEPEND): # -# SITEFILE="50${PN}-gentoo.el" +# @CODE +# SITEFILE="50${PN}-gentoo.el" +# @CODE # # Which is then installed by # -# elisp-site-file-install "${FILESDIR}/${SITEFILE}" +# @CODE +# elisp-site-file-install "${FILESDIR}/${SITEFILE}" +# @CODE # # in src_install(). Any characters after the "-gentoo" part and before # the extension will be stripped from the destination file's name. @@ -126,13 +140,15 @@ # After that you need to recreate the start-up file of Emacs after # emerging and unmerging by using # -# pkg_postinst() { -# elisp-site-regen -# } +# @CODE +# pkg_postinst() { +# elisp-site-regen +# } # -# pkg_postrm() { -# elisp-site-regen -# } +# pkg_postrm() { +# elisp-site-regen +# } +# @CODE # # When having optional Emacs support, you should prepend "use emacs &&" # to above calls of elisp-site-regen().