introduction.asciidoc

-:toc:
-[[chp:opalcycl]]
-
+:xrefstyle: short
 :stem: latexmath
 :sectnums:
+:figure-caption:
+
+:toc:
+[[chp:opalcycl]]
 
 [[chp:Introduction]]
 Introduction
@@ -59,19 +61,21 @@ emittance, slice emittance, halo extension etc.
 The following example is exemplifying this fact:
 
 .Table Parameters Parallel Performance Example
+[#pex1]
 |===
 |Distribution | Particles | Mesh | Greens Function | Time steps
 
 |Gauss 3D | latexmath:[10^8] | latexmath:[1024^3] | Integrated | 10
 |===
 
-Figure [walldrift] shows the parallel efficiency time as a function of
-used cores for a test example with parameters given in Table [pex1]. The
+Figure <<walldrift>> shows the parallel efficiency time as a function of
+used cores for a test example with parameters given in Table <<pex1>>. The
 data were obtained on a Cray XT5 at the Swiss Center for Scientific
 Computing.
 
-image:figures/drift2c1.png[caption="Parallel efficiency and particles pushed per
-as a function of cores",scaledwidth=75.0%]
+[#walldrift]
+.Parallel efficiency and particles pushed per latexmath:[\micro s] as a function of cores
+image:figures/drift2c1.png[caption="",scaledwidth=75.0%]
 
 [[quality-management]]
 Quality Management
@@ -125,7 +129,7 @@ image:figures/H5rootPicture3.png[width=300]
 Change History
 ~~~~~~~~~~~~~~
 
-See Appendix [changelog] for a detailed list of changes in `Opal`.
+See Appendix <<changelog>> for a detailed list of changes in `Opal`.
 
 [[known-issues-and-limitations]]
 Known Issues and Limitations