#lang scribble/doc

@(require scribble/manual "shared.rkt"
          (for-label racket teachpack/htdp/docs))

@teachpack["docs"]{Manipulating Simple HTML Documents}

@;declare-exporting[teachpack/htdp/docs]
@defmodule[#:require-form beginner-require htdp/docs]

The teachpack provides three functions for creating simple ``HTML'' documents: 

@deftech{Annotation} An @tech{Annotation} is a symbol that starts with ``<''
and ends in ``>''. An end annotation is one that starts with ``</''.

@defproc[(atom? [x any/c]) boolean?]{Determines whether or not a value
is a number, a symbol, or a string.} 

@defproc[(annotation? [x any/c]) boolean?]{Determines whether or not a
symbol is a document annotation.} 

@defproc[(end-annotation [x (unsyntax @tech{Annotation})]) (unsyntax @tech{Annotation})]{Consumes an annotation
and produces a matching ending annotation.} 

@defproc[(write-file [l (list-of atom)]) true]{
Consumes a list of symbols and annotations and prints them out as a
"file".}

Sample session: set teachpack to @filepath{docs.rkt} and click Run:
@(begin
#reader scribble/comment-reader
(racketblock
> (annotation? 0)
false
> (annotation? '<bold>)
true
> (end-annotation 0)
end-annotation: not an annotation: 0
> (write-file (list 'a 'b))
a b 
))