Markers
Table of Contents
Data.php
| Type | Line | Description |
|---|---|---|
| TODO | 67 | Is this really what we want to do? |
DelimiterStack.php
| Type | Line | Description |
|---|---|---|
| TODO | 235 | change $stackBottom to an int in 3.0 |
| TODO | 147 | Remove the line below once PHP 7.4 support is dropped, as WeakMap won't hold onto the reference, making this unnecessary |
| TODO | 282 | Remove this conditional check in 3.0. It only exists to prevent behavioral BC breaks in 2.x. |
ListBlock.php
| Type | Line | Description |
|---|---|---|
| TODO | 30 | Make lists tight by default in v3 |
ListBlockStartParser.php
| Type | Line | Description |
|---|---|---|
| TODO | 61 | for 3.0: Just make them tight by default in the block so we can remove this call |
DocumentBlockParser.php
| Type | Line | Description |
|---|---|---|
| TODO | 67 | for v3: It would be great if we could find an alternate way to identify such paragraphs. |
Elements.php
| Type | Line | Description |
|---|---|---|
| TODO | 19 | consider using a bitmask table lookup. There is enough overlap in naming that this could significantly shrink the size and maybe make it faster. See the Go teams implementation at https://code.google.com/p/go/source/browse/html/atom. |
DOMTreeBuilder.php
| Type | Line | Description |
|---|---|---|
| TODO | 268 | - XMLNS namespace handling (we need to parse, even if it's not valid) - XLink, MathML and SVG namespace handling - Omission rules: 8.1.2.4 Optional tags |
| TODO | 560 | Need to handle case where comment appears outside of the HTML tag. |
Tokenizer.php
| Type | Line | Description |
|---|---|---|
| TODO | 751 | This method is a little long. Should probably refactor. |
| FIXME | 83 | Add infinite loop protection. |
| TODO | 147 | is this necessary ? |
TreeBuildingRules.php
| Type | Line | Description |
|---|---|---|
| TODO | 16 | - colgroup and col special behaviors - body and head special behaviors |
OutputRules.php
| Type | Line | Description |
|---|---|---|
| TODO | 501 | Use the Entities class in php 5.3 to have html5 entities. |
| FIXME | 275 | This probably needs some flags set. |
| FIXME | 349 | Needs support for xml, xmlns, xlink, and namespaced elements. |
| TODO | 354 | Currently, this always writes name="value", and does not do |
Comment.php
| Type | Line | Description |
|---|---|---|
| TODO | 200 | Rename these to include "start". |
TokenStream.php
| Type | Line | Description |
|---|---|---|
| TODO | 233 | Handle non-space indentation |
AttributeEmulator.php
| Type | Line | Description |
|---|---|---|
| TODO | 35 | return $tokens; |
PrettyPrinterAbstract.php
| Type | Line | Description |
|---|---|---|
| FIXME | 62 | This precedence is incorrect for PHP 8. |
| TODO | 581 | Add <?php properly |
| TODO | 814 | Try to preserve formatting |
| TODO | 865 | Preserve formatting. |
| TODO | 975 | Preserve formatting. |
| TODO | 998 | Support removing single node. |
| TODO | 1471 | "yield" where both key and value are inserted doesn't work |
| TODO | 1500 | 'Stmt_TryCatch->finally' => [null, false, ' ', null], |
| TODO | 1518 | These need to be treated more carefully |
| TODO | 1621 | Insertion into empty statement lists. |
| TODO | 1697 | ]; |
ParserRulesPass.php
| Type | Line | Description |
|---|---|---|
| TODO | 35 | remove this call to $structual, body elements should not be part of it once subparser is removed |
LoadCacheHandler.php
| Type | Line | Description |
|---|---|---|
| TODO | 24 | : Load Cache |
PersistCacheHandler.php
| Type | Line | Description |
|---|---|---|
| TODO | 24 | Introduce Caching |
AbstractNode.php
| Type | Line | Description |
|---|---|---|
| TODO | 70 | accented characters to the base character |
UriFactory.php
| Type | Line | Description |
|---|---|---|
| TODO | 30 | remove this, as it is copied form phpDocumentor to make things work. |
LinesIterator.php
| Type | Line | Description |
|---|---|---|
| TODO | 96 | Revisit The Loop in {@see \phpDocumentor\Guides\RestructuredText\Parser\DocumentParserContext::parseLines()} and see if the Look Ahead timing should be done differently |
CommentRule.php
| Type | Line | Description |
|---|---|---|
| TODO | 50 | Would we want to keep a comment as a Node in the AST? |
DefinitionListRule.php
| Type | Line | Description |
|---|---|---|
| TODO | 71 | This is a workaround because the current Main Loop in {@see DocumentParser::parseLines()} expects |
LinkRule.php
| Type | Line | Description |
|---|---|---|
| TODO | 54 | pass link object to setLink |
LiteralBlockRule.php
| Type | Line | Description |
|---|---|---|
| TODO | 65 | this is a bug, we need LiteralBlockNode here |
RuleContainer.php
| Type | Line | Description |
|---|---|---|
| TODO | 53 | Change the handling of detecting MetaNodes in form of |
Linker.php
| Type | Line | Description |
|---|---|---|
| TODO | 228 | Can we find another solution for this? |
NamespaceTreeBuilder.php
| Type | Line | Description |
|---|---|---|
| TODO | 98 | find out why this can happen. Some bug in the assembler? |
ArgumentDescriptor.php
| Type | Line | Description |
|---|---|---|
| TODO | 39 | Apparently, in our Mario's example this can be null. But that is weird. Investigate this after |
FunctionAssembler.php
| Type | Line | Description |
|---|---|---|
| TODO | 70 | this looks like a potential bug. Have to investigate this! |
FileDescriptor.php
| Type | Line | Description |
|---|---|---|
| TODO | 312 | This is an item that needs to be done. |
IsTyped.php
| Type | Line | Description |
|---|---|---|
| TODO | 37 | update link to point to the final destination for the PHPDoc Standard. |
HasProperties.php
| Type | Line | Description |
|---|---|---|
| TODO | 59 | check whether this function works properly, the business logic feels off somehow |
ParseFiles.php
| Type | Line | Description |
|---|---|---|
| TODO | 37 | The setVisibility call should purge the cache if it differs; but once we are here, cache has already |
ArrayOfTypeAdapter.php
| Type | Line | Description |
|---|---|---|
| TODO | 29 | How and why is this adapter used? The assumption in the supports method is weird and that this adapter involves arrays is oddly specific. Is this a potential bug? |
UrlGenerator.php
| Type | Line | Description |
|---|---|---|
| TODO | 43 | Why is this a separate URL Generator on top of the Router, specific for the LinkRenderer? Are we missing a concept? At the moment, I am not going into this because my PR is getting too big already and I keep existing behaviour, but discovering why this Url Generator even exists could improve the codebase. |
| TODO | 86 | of course this is not correct, but phpDocumentor does not have a mechanism yet for determining the |
| TODO | 94 | of course this is not correct, but phpDocumentor does not have a mechanism yet for determining the |
| TODO | 105 | This is copied from the TableOfContentsBuilder; once we get proper support for Versions, |
| TODO | 121 | Add Support for DocumentEntries to the router |
LinkRenderer.php
| Type | Line | Description |
|---|---|---|
| TODO | 148 | Because the renderer uses an immutable pattern to change itself; the $this references |
RelativePathToRootConverter.php
| Type | Line | Description |
|---|---|---|
| TODO | 55 | References can only point to an element that is a class, interface, trait, method, property or class constant at this moment. This is because an FQSEN does not contain the necessary data to distinguish whether the FQCN is actually a class or a namespace reference. As such we assume a class as that is the most common occurrence. |
Twig.php
| Type | Line | Description |
|---|---|---|
| TODO | 139 | At a later stage we want to support more types of Documentation Sets using the Twig writer |
| TODO | 246 | replace env with origin filesystem, as this will help us to copy assets. |
StandardTagFactory.php
| Type | Line | Description |
|---|---|---|
| TODO | 354 | this method should be populated once we implement Annotation notation support. |
| TODO | 249 | Annotation support is planned for a later stage and as such is disabled for now |