{"size": 2373, "ext": "scrbl", "max_stars_repo_path": "splitflap-doc/notes.scrbl", "max_stars_repo_name": "otherjoel/splitflap", "max_stars_repo_stars_event_min_datetime": "2021-11-05T13:08:56.000Z", "max_stars_repo_stars_event_max_datetime": "2022-02-10T22:24:16.000Z", "max_issues_repo_path": "splitflap-doc/notes.scrbl", "max_issues_repo_name": "otherjoel/splitflap", "max_issues_repo_issues_event_min_datetime": "2021-10-31T01:32:55.000Z", "max_issues_repo_issues_event_max_datetime": "2022-01-10T17:27:26.000Z", "max_forks_repo_path": "splitflap-doc/notes.scrbl", "max_forks_repo_name": "otherjoel/splitflap", "max_forks_repo_forks_event_min_datetime": null, "max_forks_repo_forks_event_max_datetime": null}
{"max_stars_count": 9, "max_issues_count": 4, "max_forks_count": null, "avg_line_length": 36.5076923077, "max_line_length": 113, "alphanum_fraction": 0.7665402444}
#lang scribble/manual

@(require "misc.rkt"
          splitflap/private/version
          (for-label splitflap xml))

@title{Package Notes (@splitflap-version[])}

Splitflap can be considered stable. No backward-incompatible changes are planned.

@section{Known Issues}

See Splitflap’s @hyperlink["https://github.com/otherjoel/splitflap/issues"]{issues tracker on Github} for any
known problems with the library, or to report problems.

@subsection{Non-ASCII email addresses and domains}

The @Atom1.0[] and @RSS2.0[] specs do not contemplate or allow for the use of non-ASCII characters
in email addresses or domain names, which is a defect considering that non-English alphabets are in
widespread use for both of these things.

At this early stage I have chosen to enforce the standards as written, for consistency’s sake. I do
plan to add a parameter which would cause @racket[dns-domain?] and @racket[email-address?] to
validate strings according to some alternative scheme that allows for non-ASCII characters. In order
to do this correctly, though, I need to educate myself about any standards that exist in this area.

@section{Version History}

@subsection{Version 1.2}

@itemlist[#:style 'compact

@item{Fix exception raised in @racket[express-xml] when no entries are present
(@link["https://github.com/otherjoel/splitflap/issues/9"]{#9})}

@item{Added zero-arity form of @racket[infer-moment] to get current moment}

]

@subsection{Version 1.1}

@itemlist[#:style 'compact

@item{Fix unquoting bug in @racket[person] x-expressions
(@link["https://github.com/otherjoel/splitflap/pull/7"]{#7})}

@item{Remove dependency on @racketmodname[txexpr] package
(@link["https://github.com/otherjoel/splitflap/pull/8"]{#8})}

@item{Ensure @racket[system-language] works with Racket CS 8.4+
(@link["https://github.com/otherjoel/splitflap/commit/0da67ccdc7c0e7f84c5a34cd88f627d65fbb86f4"]{@tt{0da67ccd}})}

]


@section{Licensing}

Splitflap is provided under the terms of the
@hyperlink["https://github.com/otherjoel/splitflap/blob/main/LICENSE.md"]{Blue Oak 1.0.0 license}.

The split-flap animation in the HTML edition of this documentation comes from the 
@hyperlink["https://github.com/rjkerrison/ticker-board"]{ticker-board} project by
Robin James Kerrison, under the terms of the
@hyperlink["https://github.com/otherjoel/splitflap/blob/main/NOTICE.md"]{MIT license.}
