Skip to content

Commit

Permalink
Use the external attribute for <link ...> tags to flag internal links.
Browse files Browse the repository at this point in the history
  • Loading branch information
steve-fryatt committed Dec 28, 2021
1 parent 6361323 commit eda5b18
Show file tree
Hide file tree
Showing 3 changed files with 4 additions and 3 deletions.
4 changes: 2 additions & 2 deletions Chapters/ch01-an-example-application.xml
Original file line number Diff line number Diff line change
Expand Up @@ -46,9 +46,9 @@
<section>
<p>Over the course of this tutorial, we&rsquo;ll be looking at the different ways that panes can be used in RISC&nbsp;OS Wimp applications, and the code required to make them work. Since examples almost always make things easier to follow, we&rsquo;ll start by creating a minimalist application containing the essentials required to get the windows and their panes on to the desktop. Although we will build up that code piece by piece in this chapter, the complete application will be <reference id="dl-example-app">available to download at the end</reference> &ndash; so don&rsquo;t worry too much about copying the bits into a text editor as you go!</p>

<p>The language that we will be working in is BBC&nbsp;BASIC, although the concepts introduced should be easy enough to translate into other languages as required. The code will be self-contained, to avoid the distraction of using additional libraries, but I&rsquo;ll be borrowing a number of the routines from my <link href="../libraries">WimpLib BASIC Library</link> to save re-inventing too many wheels along the way.</p>
<p>The language that we will be working in is BBC&nbsp;BASIC, although the concepts introduced should be easy enough to translate into other languages as required. The code will be self-contained, to avoid the distraction of using additional libraries, but I&rsquo;ll be borrowing a number of the routines from my <link href="../libraries" external="false">WimpLib BASIC Library</link> to save re-inventing too many wheels along the way.</p>

<p>If you find it hard to follow any of the concepts in this chapter, it might be useful to look at a more general introduction to the Wimp first. There are a number of good books available for BASIC programmers, including <cite><link href="http://www.riscos.com/support/developers/wimpprog/index.htm">A Beginner&rsquo;s Guide To Wimp Programming</link></cite> or <cite>Wimp Programming For All</cite>, while those favouring C may wish to read my own <link href="../wimp-prog">Wimp Programming In C</link> tutorial elsewhere on this site.</p>
<p>If you find it hard to follow any of the concepts in this chapter, it might be useful to look at a more general introduction to the Wimp first. There are a number of good books available for BASIC programmers, including <cite><link href="http://www.riscos.com/support/developers/wimpprog/index.htm">A Beginner&rsquo;s Guide To Wimp Programming</link></cite> or <cite>Wimp Programming For All</cite>, while those favouring C may wish to read my own <link href="../wimp-prog" external="false">Wimp Programming In C</link> tutorial elsewhere on this site.</p>
</section>

<section>
Expand Down
2 changes: 1 addition & 1 deletion panes.xml
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@
<section>
<p>One area of the RISC&nbsp;OS Wimp which appears to be shrouded in mystery is the handling of pane windows. Whilst many modern applications will have toolbars or status displays, how they&rsquo;re implemented is something that doesn&rsquo;t seem to get a mention in any of the books on programming. Even the usually helpful <cite>Programmer&rsquo;s Reference Manual</cite> is coy on the subject.</p>

<p>This guide was written after seeing the question asked many times in the forums and newsgroups. It isn&rsquo;t intended to be a beginner&rsquo;s guide to Wimp programming, but rather a more detailed look at the specific issues surrounding the handling of pane windows within applications. If you&rsquo;re looking for an entry-level guide to the much larger subject of writing desktop applications, then for BASIC programmers I would suggest looking at <cite><link href="http://www.riscos.com/support/developers/wimpprog/index.htm">A Beginner&rsquo;s Guide To Wimp Programming</link></cite> or <cite>Wimp Programming For All</cite> (which is available to buy from R-Comp through their PlingStore application). If your preferred language is C, then you may find my own <link href="wimp-prog">Wimp Programming In C</link> tutorial helpful.</p>
<p>This guide was written after seeing the question asked many times in the forums and newsgroups. It isn&rsquo;t intended to be a beginner&rsquo;s guide to Wimp programming, but rather a more detailed look at the specific issues surrounding the handling of pane windows within applications. If you&rsquo;re looking for an entry-level guide to the much larger subject of writing desktop applications, then for BASIC programmers I would suggest looking at <cite><link href="http://www.riscos.com/support/developers/wimpprog/index.htm">A Beginner&rsquo;s Guide To Wimp Programming</link></cite> or <cite>Wimp Programming For All</cite> (which is available to buy from R-Comp through their PlingStore application). If your preferred language is C, then you may find my own <link href="wimp-prog" external="false">Wimp Programming In C</link> tutorial helpful.</p>

<p>It&rsquo;s worth remembering that these days there are many ways to handle panes. In addition to doing things the &lsquo;old-fashioned way&rsquo;, there&rsquo;s the Nested Wimp, the Toolbox and even third-party libraries such as DeskLib if you're working in C. Whilst I&rsquo;ll cover some of these here, I won&rsquo;t cover them all. If you&rsquo;re starting work on a new application, it&rsquo;s definitely worth considering the best approach &ndash; the newer, &lsquo;higher level&rsquo; solutions were created by Acorn to make developers&rsquo; lives easier!</p>

Expand Down
1 change: 1 addition & 0 deletions xmldoc.xsd
Original file line number Diff line number Diff line change
Expand Up @@ -178,6 +178,7 @@

<xsd:complexType name="LinkType">
<xsd:attribute name="href" type="xsd:string" use="required"/>
<xsd:attribute name="external" type="xsd:boolean"/>
</xsd:complexType>
</xsd:schema>

0 comments on commit eda5b18

Please sign in to comment.