Re: [Dwarf-Discuss] HTML documentation for DWARF

[Michael Eager via Dwarf-Discuss]

On 3/1/21 2:53 PM, Konrad Kleine via Dwarf-Discuss wrote:
On a side note, the comment function doesn't work: 
http://www.dwarfstd.org/Comment.php  .


The verification doesn't work there: "Verification failed. Please go 
back and try again."


Make sure that you have filled in all fields before submitting comment.

--
Michael Eager
___
Dwarf-Discuss mailing list
Dwarf-Discuss@lists.dwarfstd.org
http://lists.dwarfstd.org/listinfo.cgi/dwarf-discuss-dwarfstd.org

Re: [Dwarf-Discuss] HTML documentation for DWARF

[David Blaikie via Dwarf-Discuss]

I'd +1 that in general - probably mostly a question of who's going to do
the initial work, and how much ongoing maintenance cost it'll incur. If
you're volunteering to do the initial work, and it can be done so as to
keep the ongoing maintenance cost low - perhaps the editor(s) will be open
to it.

On Mon, Mar 1, 2021 at 2:53 PM Konrad Kleine via Dwarf-Discuss <
dwarf-discuss@lists.dwarfstd.org> wrote:

> Hi there.
>
> On a side note, the comment function doesn't work:
> http://www.dwarfstd.org/Comment.php .
>
> The verification doesn't work there: "Verification failed. Please go back
> and try again."
>
> I'm working on LLVM and LLDB and sometimes when I see a fix like the
> following I wonder why there's no link to the documentation about what
> "DW_FORM_line_strp" is doing: https://reviews.llvm.org/D97721. I would
> like to have a simple Hypertext link to the DWARF documentation. I could
> link to a specific PDF page, but that's not the same as linking to a
> section or a chapter.
>
> I'm asking if there's a way to generate not only a PDF but also a publicly
> accessible HTML from the source of the DWARF documentation. I learned that
> for DWARF4 the source was a MS Word document, so I guess that ship has
> sailed. But for the documentation in git (
> http://git.dwarfstd.org/?p=dwarf-doc.git;a=summary) I think it could be
> possible to have a documentation in HTML with URLs with /latest/ or
> /current/ or /5.0/ in it to resemble the HEAD of the development or some
> latest released or tagged version. What are the thoughts on having HTML
> documentation pages?
>
> Have you given some thought about using pandoc or publican as a more
> high-level organization for the latex sources? Those would allow different
> outputs.
>
> Regards
> Konrad
> ___
> Dwarf-Discuss mailing list
> Dwarf-Discuss@lists.dwarfstd.org
> http://lists.dwarfstd.org/listinfo.cgi/dwarf-discuss-dwarfstd.org
>
___
Dwarf-Discuss mailing list
Dwarf-Discuss@lists.dwarfstd.org
http://lists.dwarfstd.org/listinfo.cgi/dwarf-discuss-dwarfstd.org

[Dwarf-Discuss] HTML documentation for DWARF

[Konrad Kleine via Dwarf-Discuss]

Hi there.

On a side note, the comment function doesn't work:
http://www.dwarfstd.org/Comment.php .

The verification doesn't work there: "Verification failed. Please go back
and try again."

I'm working on LLVM and LLDB and sometimes when I see a fix like the
following I wonder why there's no link to the documentation about what
"DW_FORM_line_strp" is doing: https://reviews.llvm.org/D97721. I would like
to have a simple Hypertext link to the DWARF documentation. I could link to
a specific PDF page, but that's not the same as linking to a section or a
chapter.

I'm asking if there's a way to generate not only a PDF but also a publicly
accessible HTML from the source of the DWARF documentation. I learned that
for DWARF4 the source was a MS Word document, so I guess that ship has
sailed. But for the documentation in git (
http://git.dwarfstd.org/?p=dwarf-doc.git;a=summary) I think it could be
possible to have a documentation in HTML with URLs with /latest/ or
/current/ or /5.0/ in it to resemble the HEAD of the development or some
latest released or tagged version. What are the thoughts on having HTML
documentation pages?

Have you given some thought about using pandoc or publican as a more
high-level organization for the latex sources? Those would allow different
outputs.

Regards
Konrad
___
Dwarf-Discuss mailing list
Dwarf-Discuss@lists.dwarfstd.org
http://lists.dwarfstd.org/listinfo.cgi/dwarf-discuss-dwarfstd.org