diff options
| author | Jed Barber <jjbarber@y7mail.com> | 2021-01-19 02:25:44 +1100 |
|---|---|---|
| committer | Jed Barber <jjbarber@y7mail.com> | 2021-01-19 02:25:44 +1100 |
| commit | da389927ddf9240bbba10b819eb782e80a5d6bf7 (patch) | |
| tree | 88b167b892de8c419151ca9a02c16f8d4ed96bec /doc/limits.html | |
| parent | 901c7e61278f16dc5c08cbebf74c2a816cd4b4b6 (diff) | |
Basic HTML documentation added
Diffstat (limited to 'doc/limits.html')
| -rw-r--r-- | doc/limits.html | 49 |
1 files changed, 49 insertions, 0 deletions
diff --git a/doc/limits.html b/doc/limits.html new file mode 100644 index 0000000..d09fe5b --- /dev/null +++ b/doc/limits.html @@ -0,0 +1,49 @@ + +<!DOCTYPE html> + +<html lang="en"> + <head> + <meta charset="utf-8"> + <title>Limitations - Packrat Docs</title> + <link href="default.css" rel="stylesheet"> + </head> + + <body> + + + <h2>Limitations</h2> + + <a href="index.html">Return to Contents</a> + + + <h4>Recognisers</h4> + <p>While this package can be used to construct recognisers easily, this would likely + not be very efficient compared to a library more specialised for that purpose.</p> + + <h4>Cyclic Grammars</h4> + <p>Grammars that have cycles in them will be treated as any other form of left recursion + and eventually be curtailed. This means that the resulting parse graph will not have + any cycles. If you want a cyclic grammar to result in a cyclic result, then this library + is not what you are after.</p> + + <h4>Generics</h4> + <p>This library makes very heavy use of generics. If your Ada compiler has any issues + handling generics then you may experience suboptimal performance.</p> + + <h4>Parse Graph Data Structure</h4> + <p>In order to keep the parse graph to polynomial space complexity, it is a specialised + data structure and is not the same thing as a more standard directed graph.</p> + + <h4>Piecewise Parsing</h4> + <p>Due to the possibility of incomplete parses, in the worst case using piecewise parsing + can result in the lexer or parser holding the entire input in memory before returning a + result.</p> + + <h4>Error Recovery</h4> + <p>While error messages can be informative, there is currently no consideration given to + being able to recover from an error and continue parsing.</p> + + + </body> +</html> + |