Improve markdown guidelines wording
Amongst the changes here is that we do not need to have the hex or html
code (numbers) for open and close parentheses (in links) as there are
names. '(' is & followed by lpar; and the ')' is the same but 'rpar;'
instead. This makes it easier to remember and type and it generates the
same html as well (they are all valid). Now the markdown files are
consistent in this (in some cases hex was used and in others the html
code).
Although many markdown files were updated no html files needed to be
updated as it generates the same html. Even so I ran the appropriate
rules to do so just to verify this.
This commit is contained in:
1 parent
12a5837608
commit
3deb7ae603
67 files changed
+198
-187
No files matched your search
+10
-10
@@ -186,10 +186,10 @@ since there was no CS curriculum when we started). We had an assignment to
|
||||
create a pair of programs for the computer networks course. The programs were
|
||||
supposed to send data reliably from one program to the other over an unreliable
|
||||
channel. This channel was simulated with a pair of
|
||||
[pipes](https://en.wikipedia.org/wiki/Pipeline_(software)).
|
||||
[pipes](https://en.wikipedia.org/wiki/Pipeline_(software)).
|
||||
|
||||
We decided for fun to create an
|
||||
[obfuscated](https://en.wikipedia.org/wiki/Obfuscation_(software)) set of
|
||||
[obfuscated](https://en.wikipedia.org/wiki/Obfuscation_(software)) set of
|
||||
programs, only for the
|
||||
[PDP](https://en.wikipedia.org/wiki/Programmed_Data_Processor), to do this, but
|
||||
circumventing the channel (i.e. cheating, hence the needed obfuscation). Our
|
||||
@@ -205,12 +205,12 @@ there](https://groups.google.com/g/net.lang.c/c/lx-TAuEyeRI/m/HdOOnNx6LC0J) and
|
||||
it.
|
||||
|
||||
Since we had just recently created these [obfuscated
|
||||
programs](https://en.wikipedia.org/wiki/Obfuscation_(software)) we decided we could
|
||||
programs](https://en.wikipedia.org/wiki/Obfuscation_(software)) we decided we could
|
||||
use the same technique for an obfuscated C program. We upped the ante a bit by
|
||||
making it "portable".
|
||||
|
||||
To add to the
|
||||
[obfuscation](https://en.wikipedia.org/wiki/Obfuscation_(software)), we used
|
||||
[obfuscation](https://en.wikipedia.org/wiki/Obfuscation_(software)), we used
|
||||
different formats for the integers in the array: some in decimal, some in octal,
|
||||
some in hexadecimal, and when the value would fit, some as an ASCII character.
|
||||
|
||||
@@ -240,13 +240,13 @@ both a [PDP-11](https://en.wikipedia.org/wiki/PDP-11) and a
|
||||
|
||||
On the [VAX](https://en.wikipedia.org/wiki/VAX), the routine `main()` is called
|
||||
with the `calls` instruction. This instruction uses the first (2-byte)
|
||||
[word](https://en.wikipedia.org/wiki/Word_(computer_architecture)) of the called
|
||||
[word](https://en.wikipedia.org/wiki/Word_(computer_architecture)) of the called
|
||||
routine as a mask of
|
||||
[registers](https://en.wikipedia.org/wiki/Processor_register) that are to be
|
||||
saved on the [stack](https://en.wikipedia.org/wiki/Call_stack).
|
||||
In other words, on the VAX the first word can be anything. On the
|
||||
[PDP](https://en.wikipedia.org/wiki/Programmed_Data_Processor), the first word
|
||||
is a [branch](https://en.wikipedia.org/wiki/Branch_(computer_science))
|
||||
is a [branch](https://en.wikipedia.org/wiki/Branch_(computer_science))
|
||||
[instruction](https://en.wikipedia.org/wiki/Instruction_set_architecture#Instructions)
|
||||
that branches over the VAX code. The PDP and VAX codes are thus completely
|
||||
separate.
|
||||
@@ -354,7 +354,7 @@ program that we came up with is as follows:
|
||||
|
||||
The first word (after the label `vax`) is the
|
||||
[PDP](https://en.wikipedia.org/wiki/Programmed_Data_Processor) [branch
|
||||
instruction](https://en.wikipedia.org/wiki/Branch_(computer_science)).
|
||||
instruction](https://en.wikipedia.org/wiki/Branch_(computer_science)).
|
||||
[PDP](https://en.wikipedia.org/wiki/Programmed_Data_Processor) branch
|
||||
instructions are octal `400` + the distance divided by `2`. The string that both
|
||||
the [PDP](https://en.wikipedia.org/wiki/Programmed_Data_Processor) and
|
||||
@@ -364,10 +364,10 @@ programs use is after the `str` label, and the
|
||||
`pdp` label.
|
||||
|
||||
On the [VAX](https://en.wikipedia.org/wiki/VAX), the program
|
||||
[pushes](https://en.wikipedia.org/wiki/Stack_(abstract_data_type)) 9 (the length
|
||||
[pushes](https://en.wikipedia.org/wiki/Stack_(abstract_data_type)) 9 (the length
|
||||
of the string), the address of the string and 1, the [file
|
||||
descriptor](https://en.wikipedia.org/wiki/File_descriptor) on the
|
||||
[stack](https://en.wikipedia.org/wiki/Stack_(abstract_data_type)), and calls
|
||||
[stack](https://en.wikipedia.org/wiki/Stack_(abstract_data_type)), and calls
|
||||
`write(2)`. Since we didn't know the exact calling sequence for [system
|
||||
calls](https://en.wikipedia.org/wiki/System_call), we just copied the source for
|
||||
the `write(2)` system call stub into our program. After `write(2)` finishes, the
|
||||
@@ -453,7 +453,7 @@ The only problem we had was that the program had chosen an
|
||||
Since everybody knows what a [PDP-11](https://en.wikipedia.org/wiki/PDP-11)
|
||||
branch instruction looks like (everyone knows that the traditional magic word
|
||||
for an executable, `0407`, is a [PDP-11](https://en.wikipedia.org/wiki/PDP-11)
|
||||
[branch](https://en.wikipedia.org/wiki/Branch_(computer_science)), we changed
|
||||
[branch](https://en.wikipedia.org/wiki/Branch_(computer_science)), we changed
|
||||
that to [decimal](https://en.wikipedia.org/wiki/Decimal). After checking the
|
||||
size of the resulting program we saw that it was one byte too long. The limit
|
||||
was 512 bytes, and our program was 513 bytes. So we changed the word `and` in
|
||||
|
||||
Reference in new issue
Block a user