[WIP] Import from http://pike.lysator.liu.se/docs/tutorial/

[johan]

Source material: 9f05ab1 has remaining xml files. Some files, mostly those that have the SiteBuilder <metadata> block left in them, are duplicates with either other xml files, or files already converted to Markdown.

Text formatting convention used: semantic linefeeds, as summarized in this self-documenting example:

  By starting a new line at the end of each sentence,
  and splitting sentences themselves
  at natural breaks between clauses,
  a text file becomes far easier to edit and version control.

Also, aspirationally: 80 char lines at most, but for tables and the like, visual end results is what matters.

Conversion method: convert all tags to their markdown equivalents

• <list>+<item> => numbered, bullet or definition lists
• <comment> => nuke
• <interactive> => put in triple-backtick escape + prefix <in> bits with a > prompt + strip <out> tags
• <h1> => ## header

Progress:

• Introduction
  • What is Pike?
  • What Does Pike Look Like?
  • Pike and Some Other Languages
  • Reading this Tutorial
• First Steps
  • Hello World
  • I Want My Greeting in a Window!
  • Interactive Pike
• Fundamental Concepts
  • Terminology / Glossary
• Your Second Pike Program
  • The Bare Bones
  • Running the Program
  • Command-line Arguments and if
  • Methods and Loops
  • Magic Web Stuff
  • Syntactic Sugar
  • Showing the Page
  • Some Notes About WWW
• An Introduction to Data Types
  • What is a data type?
  • Basic Types
  • Container Types
  • Object, Program and Function
  • Variable Definitions
  • Basic Types and Reference Types
• Methods
  • An Introduction
  • Calling a method
  • More Advanced Examples
• Object-Oriented Programming
  • Object Orientation in General
  • Object Orientation in Pike
  • Creating and Using Objects
  • How to Create a Class
  • Classes as Record Types
  • Programs are Classes and Vice Versa
  • Inheritance
  • Multiple Inheritance
  • Access control
• Statements
  • Choosing between Alternatives
  • Repetition (or "Loops")
  • Other Statement Types
• More About Data Types
  • The Basic Types
  • Container Types
  • The Other Reference Types
• Working with Strings
  • Operators on Strings
  • Built-in Functions for Strings
  • Composing Strings with sprintf
  • Analyzing Strings with sscanf
  • Wide Strings
• Expressions
  • Some Terminology
  • Arithmetical Operations
  • Operations on Complex Types
  • Comparison
  • Logical Expressions
  • Bitwise Operations
  • Operations on Sets
  • Indexing
  • Assignment
  • Type Conversions
  • The Comma Operator
  • Call and Splice
  • Operator Precedence and Associativity
• The Preprocessor
  • Preprocessor Directives
• Modules
  • Some Examples of Modules
  • How Do You Use a Module?
  • How Do You Create a Module?
  • How Does Pike Find the Modules?
• Errors and Error Handling
  • Error Messages from Pike
  • Error Handling: the Concept
  • Detecting an Error
  • Handling the Error
  • Error Codes
  • catch and throw
• Not Covered Here

[johan]

In the original xml markup, there was a hidden comment:

<comment>Wrong!</comment>

right here. If anyone has constructive input on what that is about and if we should change something here, speak up. :-)

[grubba]

On Sun, 7 Dec 2014, Johan Sundström wrote:

+}
+```
+
+The value of(x1 + x2) / 2 will be calculated,
+giving 20.0.
+This value is then returned to the point where the method was called,
+and is used as the value of the method-call expression.
+
+Note that Pike uses "call by value".
+This means that Pike always calculates the value of the arguments
+before calling a method,
+and then it sends those values
+(or, more precisely: copies of those values)
+to the called method.
+This means that in the example
+

In the original xml markup, there was a hidden comment:

<comment>Wrong!</comment>

right here. If anyone has constructive input on what that is about and
if we should change something here, speak up. :-)

I suspect that it has to do with that some types are reference types, so
that no actual copying of the perceived value is performed for them.

/grubba

Henrik Grubbström grubba@grubba.org
Roxen Internet Software AB grubba@roxen.com