<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>This Blog Is Not For Reading &#187; code</title>
	<atom:link href="http://bob.jonkman.ca/blogs/category/code/feed/" rel="self" type="application/rss+xml" />
	<link>http://bob.jonkman.ca/blogs</link>
	<description>A blog, just like any blog, only more so</description>
	<lastBuildDate>Thu, 13 May 2010 19:09:23 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.0</generator>
		<item>
		<title>Telephone Number Format Standards</title>
		<link>http://bob.jonkman.ca/blogs/2010/03/20/telephone-number-format-standards/</link>
		<comments>http://bob.jonkman.ca/blogs/2010/03/20/telephone-number-format-standards/#comments</comments>
		<pubDate>Sat, 20 Mar 2010 05:42:35 +0000</pubDate>
		<dc:creator>Bob</dc:creator>
				<category><![CDATA[code]]></category>
		<category><![CDATA[smtp]]></category>
		<category><![CDATA[telephone]]></category>
		<category><![CDATA[valid html]]></category>

		<guid isPermaLink="false">http://bob.jonkman.ca/blogs/?p=216</guid>
		<description><![CDATA[Standardized Telephone Number formats work even on old phones! There are many different address books and directories online, and there are almost just as many different ways they store telephone numbers. I guess most people don&#8217;t realize that there are actually standards for representing phone numbers. A little bit of standardization would go a long [...]]]></description>
			<content:encoded><![CDATA[<div style="float:right;border: thin solid black;margin: .5em;padding: .1em;text-align:center;width:256px"><a href="http://www.flickr.com/photos/lwr/9257237/" title="Flickr - Leo Reynolds - Telephone Dial"><img src="http://farm1.static.flickr.com/6/9257237_a6909f8d8d_m.jpg" alt="Telephone Dial" width="240" height="240" /></a>
<p>Standardized Telephone Number formats work even on old phones!</p>
</div>
<p>There are many different address books and directories online, and there are almost just as many different ways they store telephone numbers.  I guess most people don&#8217;t realize that there are actually standards for representing phone numbers.  A little bit of standardization would go a long way towards interoperability.</p>
<p>The standard for phone number formatting is set by the International Telecommunication Union in [E.123] and [E.164] (see the references below). The standards documents are available for a fee from the ITU. A summary is available in the Google (UseNet) discussion group, titled <a href="http://groups-beta.google.com/group/comp.std.internat/msg/24fc32228689a620?dmode=source" title="Google Groups - Need ITU-T E.123 summary - comp.std.internat">Need ITU-T E.123 summary</a>.</p>
<p>In short, a North American telephone number should look like:</p>
<p>    +C-AAA-PPP-NNNN;ext=xxxx</p>
<ul>
<li> &#8220;+&#8221; shows where the dialing prefix goes. This is one of either the International Direct Dialing (IDD) prefix (for Canada this is &#8220;011&#8243; for overseas dialing) or the National Direct Dialing (NDD) prefix (&#8220;1&#8243; for calls within North America, omitted for toll-free calls),
</li>
<li>&#8220;C&#8221; is the Country Code (North America&#8217;s CC is &#8220;1&#8243;, and it is omitted for dialing within North America),
</li>
<li>&#8220;AAA&#8221; is the area code (always required for dialing in Kitchener, Toronto, and other jurisdictions),
</li>
<li>&#8220;PPP&#8221; is the Exchange (or Private Branch Exchange &#8220;PBX&#8221;; look in the phone book to see which exchanges are supported),
</li>
<li>&#8220;NNNN&#8221; is the local portion of the number,
</li>
<li>&#8220;;ext=&#8221; optionally identifies the next portion as an extension and &#8220;xxxx&#8221; are the digits for that extension. This syntax is usable in URIs and e-mail.
</li>
</ul>
<p>Note that the sequence &#8220;AAA-PPP-NNNN&#8221; is called a &#8220;local number&#8221; and &#8220;+C-AAA-PPP-NNNN&#8221; is called a &#8220;global number&#8221;. The &#8220;-&#8221; (hyphen) is a visual separator, as are &#8220;.&#8221; (period) , &#8220;(&#8221; (left bracket) and &#8220;)&#8221; (right bracket), which dialing applications should ignore.</p>
<p>I&#8217;m mostly interested in making phone number formats in e-mail addressbooks compliant with e-mail standards. The document that covers this is the IETF&#8217;s <a href="http://tools.ietf.org/html/rfc3191" title="Minimal GSTN address format in Internet Mail">RFC3191, Minimal GSTN address format in Internet Mail</a> . The requirement is that GSTN (Global Switched Telephone Network) numbers use the global-number syntax (&#8220;+C-AAA-PPP-NNNN&#8221;).</p>
<p>Global-number GSTN numbers can be used for other purposes as well, such as Web page URIs. See <a href="http://tools.ietf.org/html/rfc3966" title="The tel URI for Telephone Numbers">RFC3966, The tel URI for Telephone Numbers</a>. This document re-iterates that:</p>
<blockquote cite="http://tools.ietf.org/html/rfc3966">
<dl>
<dt>5.1.4.</dt>
<dd>Global Numbers Globally unique numbers are identified by the leading &#8220;+&#8221; character. Global numbers MUST be composed with the country (CC) and national (NSN) numbers as specified in E.123 [E.123] and E.164 [E.164]. Globally unique numbers are unambiguous everywhere in the world and SHOULD be used.
</dd>
<dt>5.1.5.</dt>
<dd>
<p>Local Numbers Local numbers are unique only within a certain geographical area or a certain part of the telephone network, e.g., a private branch exchange (PBX), a state or province, a particular local exchange carrier, or a particular country. URIs with local phone numbers should only appear in environments where all local entities can successfully set up the call by passing the number to the dialling software. Digits needed for accessing an outside line, for example, are not included in local numbers. Local numbers SHOULD NOT be used unless there is no way to represent the number as a global number.</p>
<p>Local numbers SHOULD NOT be used for several reasons. Local numbers require that the originator and recipient are configured appropriately so that they can insert and recognize the correct context descriptors. Since there is no algorithm to pick the same descriptor independently, labelling numbers with their context increases the chances of misconfiguration so that valid identifiers are rejected by mistake. The algorithm to select descriptors was chosen so that accidental collisions would be rare, but they cannot be ruled out.&lt;/p
</dd>
</dl>
</blockquote>
<p>If you work at a company that does work with organizations and staff members outside of the context of your area code (ie. internationally) be sure to standardize your directory on global-number syntax.</p>
<p>&#8211;Bob.</p>
<div style="border:thin solid black;background: #888;margin-left:auto;margin-right:auto;margin-top:2ex;margin-bottom:4ex;width: 80%;padding:3em;text-align:center">Need a consultant? Bob Jonkman can be reached by telephone at <b>+1-519-635-9413</b></div>
<p>References:</p>
<ul>
<li>[E.123] ITU-T Recommendation E.123: Telephone Network and ISDN<br />
Operation, Numbering, Routing and Mobile Service: Notation<br />
for National and International Telephone Numbers. 1993.<br />
<a href="http://www.itu.int/rec/recommendation.asp?type=items&amp;lang=e&amp;parent=T-REC-E.123-200102-I" title="E.123 : Notation for national and international telephone numbers, e-mail addresses and Web addresses">http://www.itu.int/rec/recommendation.asp?type=items&amp;lang=e&amp;parent=T-REC-E.123-200102-I</a></p>
<p>&nbsp;</p>
</li>
<li>
A summary of [E.123] is available:<br />
<a href="http://groups-beta.google.com/group/comp.std.internat/msg/24fc32228689a620?dmode=source" title="Google Groups - Need ITU-T E.123 summary - comp.std.internat">http://groups-beta.google.com/group/comp.std.internat/msg/24fc32228689a620?dmode=source</a></p>
<p>&nbsp;</p>
</li>
<li>
[E.164] ITU-T Recommendation E.164/I.331 (05/97): The International<br />
Public Telecommunication Numbering Plan. 1997.<br />
<a href="http://www.itu.int/rec/recommendation.asp?type=items&amp;lang=e&amp;parent=T-REC-E.164-200502-I" title="E.164 : The international public telecommunication numbering plan">http://www.itu.int/rec/recommendation.asp?type=items&amp;lang=e&amp;parent=T-REC-E.164-200502-I</a></p>
<p>&nbsp;</p>
</li>
<li>
A summary of [E.164] is available:<br />
<a href="http://en.wikipedia.org/wiki/E.164" title="Wikipedia - E.164">http://en.wikipedia.org/wiki/E.164</a></p>
<p>&nbsp;</p>
</li>
<li>
International Telecommunications Union -<br />
Telecommunications Standardization Sector (ITU-T)<br />
Phillips Business Information Inc. <br />
1201 Seven Locks Road, Suite 300<br />
Potomac, MD 20854</p>
<p>or call: +1-800-666-4266</p>
<p>&nbsp;</p>
</li>
<li>
See also: INTERNATIONAL DIALING CODES<br />
<a href="http://countrycode.org/" title="Country Codes, Phone Codes, Dialing Codes, Telephone Codes, ISO Country Codes">http://countrycode.org/</a></p>
<p>&nbsp;</p>
</li>
<li>
RFC3191: Minimal GSTN address format in Internet Mail<br />
<a href="http://www.rfc-editor.org/rfc/rfc3191.txt" title="Minimal GSTN address format in Internet Mail">http://www.rfc-editor.org/rfc/rfc3191.txt</a></p>
<p>&nbsp;</p>
</li>
<li>
RFC3192: Minimal FAX address format in Internet Mail<br />
<a href="http://www.rfc-editor.org/rfc/rfc3192.txt" title="Minimal FAX address format in Internet Mail">http://www.rfc-editor.org/rfc/rfc3192.txt</a></p>
<p>&nbsp;</p>
</li>
<li>
RFC2846: GSTN Address Element Extensions in E-mail Services<br />
<a href="http://www.rfc-editor.org/rfc/rfc2846.txt" title="GSTN Address Element Extensions in E-mail Service">http://www.rfc-editor.org/rfc/rfc2846.txt</a></p>
<p>&nbsp;</p>
</li>
<li>
RFC3601: Text String Notation for Dial Sequences and Global Switched Telephone Network (GSTN) / E.164 Addresses<br />
<a href="http://www.rfc-editor.org/rfc/rfc3601.txt" title="Text String Notation for Dial Sequences and Global Switched Telephone Network (GSTN) / E.164 Addresses">http://www.rfc-editor.org/rfc/rfc3601.txt</a>
</li>
</ul>
<p style="font-size:smaller">Image: <a href="http://www.flickr.com/photos/lwr/9257237/" title="Flickr - Leo Reynolds - Telephone Dial">Telephone Dial</a> by Leo Reynolds, used under <a href="http://creativecommons.org/licenses/by-nc-sa/2.0/deed.en" title="Creative Commons - Attribution-Noncommercial-Share Alike 2.0 Generic">Creative Commons v2.0 BY-NC-SA</a>.</p>
]]></content:encoded>
			<wfw:commentRss>http://bob.jonkman.ca/blogs/2010/03/20/telephone-number-format-standards/feed/</wfw:commentRss>
		<slash:comments>3</slash:comments>
		</item>
		<item>
		<title>Welcome back!</title>
		<link>http://bob.jonkman.ca/blogs/2009/10/16/welcome-back/</link>
		<comments>http://bob.jonkman.ca/blogs/2009/10/16/welcome-back/#comments</comments>
		<pubDate>Fri, 16 Oct 2009 08:37:49 +0000</pubDate>
		<dc:creator>Bob</dc:creator>
				<category><![CDATA[blogging]]></category>
		<category><![CDATA[code]]></category>

		<guid isPermaLink="false">http://bob.jonkman.ca/blogs/?p=19</guid>
		<description><![CDATA[This blog is not for reading at its new location&#8230; Here! In politics, this would be called &#8220;crossing the floor&#8221; &#8212; not only did this blog move to a new domain name, but the underlying software has changed from Blogger to WordPress. There&#8217;s a political statement if ever there was one. The move isn&#8217;t done [...]]]></description>
			<content:encoded><![CDATA[<div id="attachment_32" class="wp-caption alignright" style="width: 180px"><a href="http://picasaweb.google.com/lh/photo/S6bkFOBx-hhAp3P22HfH9g"><img class="size-full wp-image-32" src="http://bob.jonkman.ca/blogs/files/2009/10/walking_letters.gif" alt="Crossing the Floor" width="170" height="266" /></a><p class="wp-caption-text">Crossing the Floor</p></div>
<p>This blog is not for reading at its new location&#8230;  Here!</p>
<p>In politics, this would be called &#8220;crossing the floor&#8221; &#8212; not only did this blog move to a new domain name, but the underlying software has changed from <a title="Blogger: Create your free blog" href="https://www.blogger.com/start">Blogger</a> to <a title="WordPress &gt; Blog Tool and Publishing Platform" href="http://wordpress.org/">WordPress</a>.  There&#8217;s a political statement if ever there was one.</p>
<p>The move isn&#8217;t done yet.  There may be some superficial colour and layout changes, some slightly more substantial tweaking of sidebars and widgets, and possibly a very substantial URL change (I&#8217;d really like to get rid of &#8220;blogs&#8221; in <a title="Welcome Back! - This Blog Is Not For Reading" href="http://bob.jonkman.ca/blogs/2009/10/16/welcome-back/">http://bob.jonkman.ca/<em>blogs</em>/2009/10/16/welcome-back/</a>, but keep the sign-in page at <a title="Jonkman Family Blogs" href="http://jonkman.ca/blogs/">http://jonkman.ca/blogs/</a>.  Technical advice for crafting Apache rewrite code is welcome, and will be duly credited.</p>
<p>Now that it&#8217;s on the Jonkman Family web site, I hope there are other Jonkman family members who start their own blogs here too.  You&#8217;ll need an e-mail address in the @jonkman.ca domain, but those addresses are <a title="Send a request to Bob Jonkman for an @jonkman.ca e-mail address" href="mailto:bjonkman@sobac.com?subject=jonkman.ca%20e-mail%20address&amp;body=Hi!%20I'd%20like%20to%20get%20an%20@jonkman.ca%20e-mail%20address">available for the asking</a>.</p>
<p>&#8211;Bob.</p>
<p>(image from <a title="Nizzlebop's Gallery, Picasa Web Albums" href="http://picasaweb.google.com/lh/photo/S6bkFOBx-hhAp3P22HfH9g">Nizzlebop&#8217;s Gallery</a>, labelled for re-use by <a title="Google Image Search for &quot;walking letters&quot;" href="http://images.google.ca/images?as_q=walking+letters&amp;imgtbs=r&amp;as_rights=%28cc_publicdomain|cc_attribute|cc_sharealike|cc_noncommercial|cc_nonderived%29&amp;hl=en&amp;rlz=1B3GGGL_enCA264CA264&amp;um=1&amp;btnG=Google+Search&amp;as_epq=&amp;as_oq=&amp;as_eq=&amp;imgtype=&amp;imgsz=&amp;imgw=&amp;imgh=&amp;imgar=&amp;as_filetype=&amp;imgc=&amp;as_sitesearch=&amp;as_rights=%28cc_publicdomain|cc_attribute|cc_sharealike|cc_noncommercial|cc_nonderived%29&amp;safe=off&amp;as_st=y">Google Image Search</a>)</p>
]]></content:encoded>
			<wfw:commentRss>http://bob.jonkman.ca/blogs/2009/10/16/welcome-back/feed/</wfw:commentRss>
		<slash:comments>2</slash:comments>
		</item>
		<item>
		<title>Putting up the Christmas tree</title>
		<link>http://bob.jonkman.ca/blogs/2008/12/14/putting-up-the-christmas-tree/</link>
		<comments>http://bob.jonkman.ca/blogs/2008/12/14/putting-up-the-christmas-tree/#comments</comments>
		<pubDate>Sun, 14 Dec 2008 22:44:00 +0000</pubDate>
		<dc:creator>Bob</dc:creator>
				<category><![CDATA[Christmas]]></category>
		<category><![CDATA[code]]></category>
		<category><![CDATA[pseudocode]]></category>
		<category><![CDATA[tree]]></category>

		<guid isPermaLink="false">http://bob.jonkman.ca/blogs/2008/12/14/putting-up-the-christmas-tree/</guid>
		<description><![CDATA[# Program: trimtree# Purpose: To prepare a Christmas tree before decorating# Date: before 25 December repeat until (height == 0) { if (wife == &#8220;It&#8217;s lopsided!&#8221;) { trim_bottom_branches(leftside) } if (wife == &#8220;It&#8217;s leaning!&#8221;) { trim_bottom_branches(rightside) } if (wife == &#8220;It&#8217;s bare at the bottom!&#8221;) { saw_off_base(to branches) } }end loop Image by Tom Carmony, [...]]]></description>
			<content:encoded><![CDATA[<p><a href="http://www.flickr.com/photos/fabrico/345626941/" title="Flickr - A Sad Lil' Christmas Tree"><img src="http://farm1.static.flickr.com/126/345626941_6727b27224_m.jpg" alt="Christmas Tree" border="1"></a>
<div style="font-family: monospace"># Program: trimtree<br /># Purpose: To prepare a Christmas tree before decorating<br /># Date:    before 25 December</p>
<p>repeat until (height == 0)<br />   {<br />     if (wife == &#8220;It&#8217;s lopsided!&#8221;)<br />        {<br />           trim_bottom_branches(leftside)<br />        }</p>
<p>     if (wife == &#8220;It&#8217;s leaning!&#8221;)<br />        {<br />           trim_bottom_branches(rightside)<br />        }</p>
<p>     if (wife == &#8220;It&#8217;s bare at the bottom!&#8221;)<br />        {<br />           saw_off_base(to branches)<br />        } <br />    }<br />end loop</div>
<p><a href="http://www.flickr.com/photos/fabrico/345626941/" title="Flickr - A Sad Lil' Christmas Tree">Image by Tom Carmony, used under CC</a></p>
]]></content:encoded>
			<wfw:commentRss>http://bob.jonkman.ca/blogs/2008/12/14/putting-up-the-christmas-tree/feed/</wfw:commentRss>
		<slash:comments>4</slash:comments>
		</item>
	</channel>
</rss>
