HaxeFoundation / HaxeFoundation/HaxeManual

HXML file format is underspecified.

Open
#305 0 comments 0 reactions 0 assignees View on GitHub
help wanted
Dominant language
Haxe
Stars
225
Forks
156
Avg merge
5h 16m
Merged PRs (30d)
1

Description

On the HXML page (hhttp://haxe.org/manual/compiler-usage-hxml.html), it does not discuss whether the options/directives in an HXML file can all be placed on a single line, or whether each option *must* be on a separate line. (And, in practice, it appears that no-argument options can be placed on a single line, but multi-argument options cannot.

This needs to be specified, one way or another, so that tools can parse or format them properly.

Contributor guide

No contributing guide indexed for this repository

Research direction

Read the HXML page at haxe.org/manual/compiler-usage-hxml.html and verify how no-argument and multi-argument options behave when placed on one line. Update the page to specify whether directives may share a line or must be separated, including the observed distinction, so tools can parse and format HXML consistently.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.