     [file texiutils.texi not included]

tech

@uref tests
Alper Ersoy
Tim Janik

Document revised:

This document is used as a markup and document generation testbed and covers a few examples, e.g. for linking to other documents.

Font Families
*************

@docfont{ARG} styles:

Possible parameters to @docfont are: tech, techstyle, sans, sans-serif for Sans Serif; and story, storystyle, serif for Serif; Default is serif on all outputs.

Block Enclosing Commands
************************

Regular Paragraph
=================

This is a regular paragraph that should be used for normal text flow. Text is filled, no indentation and no change made to the document font.  you get if you do not use any commands.

@quotation
==========

     This is a @quotation block. It should be used to indicate text that is quoted. The text is filled, indented and printed in a roman font by default.

@example
========

     This is a @example block. Illustrate code, commands,
     and the like. The text is printed in a fixed-width font, and
     indented but not filled.  (Right now this does not look like
     how it is described here. That is because we have to use
     something instead of the buggy @verbatim command and
     @example is a good candidate.)

@smallexample
=============

     This is a @smallexample block. Same as
     @example, except that in TeX this command typesets
     text in a smaller font. (Right now this does not look like how
     it is described here. That is because we have to use something
     instead of the buggy @verbatim command and @example is a
     good candidate.)

@lisp
=====

     This is a @lisp block. Like @example, but specifically
     for illustrating Lisp code. The text is printed in a
     fixed-width font, and indented but not filled.

@smallisp
=========

     This is a @smalllisp block. It is to @lisp as @smallexample
     is to @example.

@display
========

     This is a @display block. Display illustrative text. The text is indented
     but not filled, and no font is selected (so, by default, the font is roman).

@smalldisplay
=============

     This is a @smalldisplay block. It is to @display as @smallexample
     is to @example.

@format
=======

     This is a @format block. Like @display (the text is not
     filled and no font is selected), but the text is not indented.

@smallformat
============

     This is a @smallformat block. It is to @format as @smallexample
     is to @example.

Linking
*******

HTTP
====

  * @uref{http://www.gtk.org}: http://www.gtk.org

  * @uref{http://www.gtk.org, Gtk+ Home}: Gtk+ Home (http://www.gtk.org)

  * @uref{http://www.gtk.org,, Gtk+ Home}: Gtk+ Home

FTP
===

  * @uref{ftp://ftp.gtk.org}: ftp://ftp.gtk.org

  * @uref{ftp://ftp.gtk.org, Gtk+ Ftp Site}: Gtk+ Ftp Site (ftp://ftp.gtk.org)

  * @uref{ftp://ftp.gtk.org,, Gtk+ Ftp Site}: Gtk+ Ftp Site

FILE
====

  * @uref{file:///etc/profile}: file:///etc/profile

  * @uref{file:///etc/profile, Profile}: Profile (file:///etc/profile)

  * @uref{file:///etc/profile,, Profile}: Profile

MAILTO
======

Regular Linking
---------------

  * @uref{mailto://timj@gtk.org}: mailto://timj@gtk.org

  * @uref{mailto://timj@gtk.org, Maintainer}: Maintainer (mailto://timj@gtk.org)

  * @uref{mailto://timj@gtk.org,, Maintainer}: Maintainer

Alternative Syntax (a la HTML)
------------------------------

  * @uref{mailto:timj@gtk.org}: mailto:timj@gtk.org

  * @uref{mailto:timj@gtk.org, Maintainer}: Maintainer (mailto:timj@gtk.org)

  * @uref{mailto:timj@gtk.org,, Maintainer}: Maintainer

NEWS
====

  * @uref{news://news.gtk.org/apps.beast}: news://news.gtk.org/apps.beast

  * @uref{news://news.gtk.org/apps.beast, Beast Newsgroup}: Beast Newsgroup (news://news.gtk.org/apps.beast)

  * @uref{news://news.gtk.org/apps.beast,, Beast Newsgroup}: Beast Newsgroup

man
===

System man Pages
----------------

  * @uref{man://1/bash}: man://1/bash

  * @uref{man://1/bash, Bash}: Bash (man://1/bash)

  * @uref{man://1/bash,, Bash}: Bash

man Pages
---------

  * @uref{beast-man://3/beast-gxk}: beast-man://3/beast-gxk

  * @uref{beast-man://3/beast-gxk, GUI Extension Kit}: GUI Extension Kit (beast-man://3/beast-gxk)

  * @uref{beast-man://3/beast-gxk,, GUI Extension Kit}: GUI Extension Kit

Documents
=========

Please note that using @xref command instead of these URL schemes might be a  better alternative in some situations.

Regular Linking
---------------

  * @uref{beast-doc://quickstart}: beast-doc://quickstart

  * @uref{beast-doc://quickstart, Quickstart Guide}: Quickstart Guide (beast-doc://quickstart)

  * @uref{beast-doc://quickstart,, Quickstart Guide}: Quickstart Guide

Linking With Anchors
--------------------

  * @uref{beast-doc://quickstart#node-2}: beast-doc://quickstart#node-2

  * @uref{beast-doc://quickstart#node-2, Setting Up Songs}: Setting Up Songs (beast-doc://quickstart#node-2)

  * @uref{beast-doc://quickstart#node-2,, Setting Up Songs}: Setting Up Songs

Other/Unknown (ie. gopher)
==========================

  * @uref{gopher://gopher.gtk.org}: gopher://gopher.gtk.org

  * @uref{gopher://gopher.gtk.org, Gtk+ Gopher}: Gtk+ Gopher (gopher://gopher.gtk.org)

  * @uref{gopher://gopher.gtk.org,, Gtk+ Gopher}: Gtk+ Gopher

Referencing
***********

@xref
=====

@xref{Linking}
     See Linking.

@xref{Linking, Uniform Resource Locators}
     See Uniform Resource Locators.

@xref{Linking, Uniform Resource Locators, Linking}
     See Linking.

@xref{Creating Modules, Creating And Connecting Modules, Creating And Connecting Modules, quickstart.info}
     See Creating And Connecting Modules (quickstart.info).

@xref{Creating Modules, Creating And Connecting Modules, Creating And Connecting Modules, quickstart.info, Quick Start Guide}
     See Creating And Connecting Modules (Quick Start Guide).

@xref{better alternative}
     See better alternative. (Created via @anchor)