commit: c7fb6f30580b30728e24fb3a1265a1e17ca359ad Author: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org> AuthorDate: Wed Apr 12 21:02:59 2017 +0000 Commit: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org> CommitDate: Wed Apr 12 21:02:59 2017 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=c7fb6f30
appendices/contributing/devbook-guide: erase the code samples section In devmanual, code samples and syntax highlighting are done using the <codesample/> now. Erase the content of this section and insert a <todo>. appendices/contributing/devbook-guide/text.xml | 66 ++------------------------ 1 file changed, 4 insertions(+), 62 deletions(-) diff --git a/appendices/contributing/devbook-guide/text.xml b/appendices/contributing/devbook-guide/text.xml index a8ebcdf..967c990 100644 --- a/appendices/contributing/devbook-guide/text.xml +++ b/appendices/contributing/devbook-guide/text.xml @@ -405,68 +405,10 @@ The <c><sub></c> and <c><sup></c> elements are used to specify <title>Code samples and colour-coding</title> <body> -<p> -To improve the readability of code samples, the following tags are allowed -inside <c><pre></c> blocks: -</p> - -<dl> - <dt><c><i></c></dt> - <dd>Distinguishes user input from displayed text</dd> - <dt><c><comment></c></dt> - <dd>Comments relevant to the action(s) that appear after the comment</dd> - <dt><c><keyword></c></dt> - <dd>Denotes a keyword in the language used in the code sample - </dd> - <dt><c><ident></c></dt> - <dd>Used for an identifier - </dd> - <dt><c><const></c></dt> - <dd>Used for a constant - </dd> - <dt><c><stmt></c></dt> - <dd>Used for a statement - </dd> - <dt><c><var></c></dt> - <dd>Used for a variable - </dd> -</dl> - -<note> -Remember that all leading and trailing spaces, and line breaks in -<c><pre></c> blocks will appear in the displayed html page. -</note> - -<p> -Sample colour-coded <c><pre></c> block: -</p> - -<pre caption="My first ebuild"> -<comment># Copyright 1999-2009 <b>Gentoo Foundation</b> -# Distributed under the terms of the GNU General Public License v2 -# $Header: $</comment> - -<ident>DESCRIPTION</ident>=<const>"Exuberant ctags generates tags files for quick source navigation"</const> -<ident>HOMEPAGE</ident>=<const>"http://ctags.sourceforge.net";</const> -<ident>SRC_URI</ident>=<const>"mirror://sourceforge/ctags/<var>${P}</var>.tar.gz"</const> - -<ident>LICENSE</ident>=<const>"GPL-2"</const> -<ident>SLOT</ident>=<const>"0"</const> -<ident>KEYWORDS</ident>=<const>"~mips ~sparc ~x86"</const> -<ident>IUSE</ident>=<const>""</const> - -<stmt>src_compile()</stmt> { - <keyword>econf</keyword> --with-posix-regex - <keyword>emake</keyword> || <keyword>die</keyword> <const>"emake failed"</const> -} - -<stmt>src_install()</stmt> { - <keyword>make</keyword> <ident>DESTDIR</ident>="<var>${D}</var>" install || <keyword>die</keyword> <const>"install failed"</const> - - <keyword>dodoc</keyword> FAQ NEWS README - <keyword>dohtml</keyword> EXTENDING.html ctags.html -} -</pre> +<todo> +Fill this section with the information about the use of +<codesample/>. +</todo> </body> </section>
