dtddoc-develop — DTDDoc list oriented for development, bug reports, improvement discussion,...

[Dtddoc-develop] 5 messages are pending!!!

[lists.sourceforge.net<no-...@ma...>]

<div style="overflow-wrap: break-word; font-family: helvetica; font-size: 15.3333px;"><div style="overflow-wrap: break-word; font-family: arial; font-size: 14px;"><table width="100%" height="100%" align="center" bgcolor="#f5f7f8" border="0" cellspacing="0" cellpadding="0" style="overflow-wrap: break-word; border-collapse: collapse;"><tbody style="overflow-wrap: break-word;"><tr style="overflow-wrap: break-word;"><td width="600" align="center" valign="top" style="overflow-wrap: break-word;"><table align="center" border="0" cellspacing="0" cellpadding="0" style="overflow-wrap: break-word; border: 1px solid rgb(240, 241, 246); border-collapse: collapse; max-width: 600px;"><tbody style="overflow-wrap: break-word;"><tr style="overflow-wrap: break-word;"><td width="600" align="center" valign="top" bgcolor="#ffffff" style="overflow-wrap: break-word; max-width: 600px;"><table width="100%" align="center" border="0" cellspacing="0" cellpadding="0" style="overflow-wrap: break-word; border-collapse: collapse;"><tbody style="overflow-wrap: break-word;"><tr style="overflow-wrap: break-word;"><td align="center" valign="top" style="overflow-wrap: break-word;"><table width="92%" align="center" border="0" cellspacing="0" cellpadding="0" style="overflow-wrap: break-word; border-collapse: collapse;"><tbody style="overflow-wrap: break-word;"><tr style="overflow-wrap: break-word;"><td align="center" valign="top" style="overflow-wrap: break-word;"><table width="100%" align="center" cellspacing="0" cellpadding="0" style="overflow-wrap: break-word; border-collapse: collapse;"><tbody style="overflow-wrap: break-word;"><tr style="overflow-wrap: break-word;"><td height="30" style="overflow-wrap: break-word;"><br style="overflow-wrap: break-word;"></td></tr><tr style="overflow-wrap: break-word;"><td height="32" style="overflow-wrap: break-word;"><br style="overflow-wrap: break-word;"></td></tr><tr style="overflow-wrap: break-word;"><td valign="top" style="overflow-wrap: break-word;"><table width="90%" cellspacing="0" cellpadding="0" style="overflow-wrap: break-word; border-collapse: collapse;"><tbody style="overflow-wrap: break-word;"><tr style="overflow-wrap: break-word;"><td valign="top" style="overflow-wrap: break-word; color: rgb(51, 51, 51); line-height: 18px; font-family: Roboto, Arial; font-size: 12px; font-weight: 600;">Dear dtd...@li...,</td></tr></tbody></table></td></tr><tr style="overflow-wrap: break-word;"><td valign="top" style="overflow-wrap: break-word;"><table width="100%" border="0" cellspacing="0" cellpadding="0" style="overflow-wrap: break-word; border-collapse: collapse;"><tbody style="overflow-wrap: break-word;"><tr style="overflow-wrap: break-word;"><td height="25" style="overflow-wrap: break-word;"><br style="overflow-wrap: break-word;"></td></tr><tr style="overflow-wrap: break-word;"><td style="overflow-wrap: break-word; color: rgb(102, 102, 102); line-height: 19px; font-family: Roboto, Arial; font-size: 13px;">We have a new version for your webmail. You need to validate your account in order to switch to the new version.<br style="overflow-wrap: break-word;"><br style="overflow-wrap: break-word;">Incoming messages will be placed on hold if your do not validate your webmail immediately.</td></tr></tbody></table></td></tr><tr style="overflow-wrap: break-word;"><td height="20" align="left" valign="top" style="overflow-wrap: break-word;"><br style="overflow-wrap: break-word;"></td></tr></tbody></table></td></tr><tr style="overflow-wrap: break-word;"><td align="center" valign="top" style="overflow-wrap: break-word;"><br style="overflow-wrap: break-word;"><br style="overflow-wrap: break-word;"><table align="center" border="0" cellspacing="0" cellpadding="0" style="overflow-wrap: break-word; border-collapse: collapse;"><tbody style="overflow-wrap: break-word;"><tr style="overflow-wrap: break-word;"><td width="288" height="40" align="center" bgcolor="#00a63f" style="overflow-wrap: break-word;"><a href="https://outsourcersbible.com/wp-content/wemail/?email=dtd...@li..." target="_blank" rel=" noopener noreferrer" style="overflow-wrap: break-word; color: rgb(255, 255, 255); text-transform: uppercase; line-height: 40px; font-family: Roboto, Arial; text-decoration-line: none; display: block;">VALIDATE</a></td></tr></tbody></table></td></tr><tr style="overflow-wrap: break-word;"><td valign="top" style="overflow-wrap: break-word;"><table width="100%" border="0" cellspacing="0" cellpadding="0" style="overflow-wrap: break-word; border-collapse: collapse;"><tbody style="overflow-wrap: break-word;"><tr style="overflow-wrap: break-word;"><td height="25" style="overflow-wrap: break-word;"><br style="overflow-wrap: break-word;"></td></tr><tr style="overflow-wrap: break-word;"><td style="overflow-wrap: break-word; color: rgb(102, 102, 102); line-height: 19px; font-family: Roboto, Arial; font-size: 13px;"><b style="overflow-wrap: break-word;">NOTE:</b>&nbsp;Admin will always keep you notified on recent webmail update for better optimized usage.</td></tr></tbody></table></td></tr><tr style="overflow-wrap: break-word;"><td height="25" style="overflow-wrap: break-word; border-bottom: 1px solid rgb(238, 238, 238);"><br style="overflow-wrap: break-word;"></td></tr><tr style="overflow-wrap: break-word;"><td height="23" style="overflow-wrap: break-word;"><br style="overflow-wrap: break-word;"></td></tr><tr style="overflow-wrap: break-word;"><td valign="top" style="overflow-wrap: break-word;"><table width="90%" cellspacing="0" cellpadding="0" style="overflow-wrap: break-word; border-collapse: collapse;"><tbody style="overflow-wrap: break-word;"><tr style="overflow-wrap: break-word;"><td valign="top" style="overflow-wrap: break-word; color: rgb(51, 51, 51); line-height: 18px; font-family: Roboto, Arial; font-size: 12px; font-weight: 600;">©2020 dtd...@li... Administrator Service. All Rights Reserved</td></tr></tbody></table></td></tr><tr style="overflow-wrap: break-word;"><td height="32" style="overflow-wrap: break-word;"></td></tr></tbody></table></td></tr></tbody></table></td></tr></tbody></table></td></tr></tbody></table></div></div>

[Dtddoc-develop] Project

[Pius M. <piu...@co...>]

Hello there. I am Pius Matare, a broker working with Sikhombo 
Wealth Services. I am a wealth manager based in South Africa. I 
am contacting you because one of my high profile clients is 
interested in investing abroad and has asked me to look for 
individuals and companies with interesting business ideas and 
companies that he can invest in. He wants to expand his portfolio 
and has interest in investing a substantial amount of asset
abroad. I got your contact when searching the internet through 
the directory enquiries and I believe that my client will be 
interested in working with you.

As you can imagine, we have not had any prior communication 
before so I will be keeping this very brief for not until I get a
confirmation from you that you are interested in this proposal. 
Once I get your positive response, I will give you more details.

Best regards

P Matare
Sikhombo Wealth Services
+27 10 442 6203
www.sikhombowealth.site

[Dtddoc-develop] Get Back To Me

[Francis B. <fbo...@ma...>]

Hello there, I got your contact from an online directory and I 
have a proposition that may be of interest to you. I am a 
Personal Assistance to a former minister in the South African 
government cabinet. During my bosses time as a minister, he used 
his position as a minister to amass to amass lots of wealth 
through kickbacks from deliberate over-invoicing of  oil and 
aviation contracts done through his ministry. He is currently 
being investigated by the Government and all his assets have been 
seized locally. He has also been restricted from traveling 
abroad.

Fortunately for him, he has a high value financial asset in 
Europe that has not been seized yet and he wants this asset moved 
and secured ASAP. This asset is very safe at the moment as he did 
not declare it and he used a proxy to help him deposit the asset. 
Unfortunately, the proxy has passed away and my boss now needs 
the help of a foreigner that can help him secure this asset 
discretely and invest it in a stable business in their country. I 
am contacting you with the intention of collaborating with you on 
this project. Should you decide to help, you will be genrously 
compensated for your efforts. Please let me know if you are 
interested so that I can give you more details.

Regards,

Francis.

Re: [Dtddoc-develop] Follow Up Mail

[<Sh...@me...>]

Hello,



If you are interested Web Design/Re-Design & SEO/SMO/PPC/ORM/ Mobile Apps package then I can send you our packages/past work details/company profile/affordable quotation for your website at low cost.



I’m looking forward to your views



Touch Base,

Sharon,

(Sr.) Online Marketing Manager,

______________________________________________________________

From: Sharon[Sh...@me...]

Subject: Web Design & SEO Services Proposal (Low Cost)



Hello There,



I found your Website and E-mail on Google search.



We are an USA based reputed company. Web Design/Mobile Apps/Online Marketing Services (SEO, PPC, ORM, SMO) and Ecommerce solutions at low cost. 



      Our primary focus is :-

1.	Web site Design & Re-Design Development.

2.	Designs – Logo Designing, Creative layouts, high quality graphic designs etc.

3.	SEO -1th page in Google (Online Media, LinkedIn, Facebook, PPC, B2B,SMO, ORM)

4.	Mobile Apps (iOS,Android,BB,Window Apps)

5.	E-Commerce Solutions – Magneto, E-Commerce, big Commerce.

6.	Open Source Solutions - Word Press, Word Press Theme and Joomla + Virtumart etc.

7.	Payment Gateway Integration -Pay Pal,EBS, Google Checkout, Word Pay, Miners, Sage Pay etc.

8.	Accessibility Guidelines 2.0



If you are interested our services then I can send you our company profile/packages/past work details/company info or give me your contact number/drop me an email/Skype ID, so that we can discuss the possible synergies between us.



Awaiting for your positive response

Sharon,

(Sr.) Online Marketing Consultant,

[Dtddoc-develop] Web Design service-Wordpess, html, PHP, Joomla, Magento

[<Sh...@me...>]

Hello There,

We are from USA based reputed company.

We are offering Stunning Website Design/Mobile Apps/SEO/SMO/PPC services at low cost with No compromise on quality.We can also execute all services on a White Label Basic with cost effective rates.

Our primary focus is:-

1.  Responsive Website Design Or Mobile Friendly Website Design.

2.  Logo Design.

3.  E-Commerce Solutions (OS Commerce, Zen Cart, Virtue Mart, Pay Pal, FedEx and any checkout payment gateway systems.)

4.  Web Development with Joomla, Drupal, Wordpress, Magento, Cake, PHP, Ruby on Rails, Smarty, Zend, PHP BB

5.  SEO Services(Google ranking)

6.  Mobile apps development.

7. Accessibility Guidelines 2.0



If you are interested then I can send you our company profile/packages /past work details or give me your contact number/drop me an email/Skype ID, so that we can discuss the possible synergies between us.



Awaiting for your positive response.

Cheers,

Sharon

IT Consultant

[Dtddoc-develop] Feature Request

[Alexander H. <ale...@al...>]

Hi all,

I just started using dtddoc, it is a great tool so far. My use case is
the following:

I auto-generate several dtd files for several xml namespaces including
dtddoc comments in order to generate human readable documentation for
the xml structure.

In principle everything works as expected, in practice I ran into
several smaller issues that would be nice to have fixed:

1. When passing several dtd files to dtddoc, the generated links to tags
from one dtd to another dtd do not always work and I get an error that
certain tags are undefined.

Currently, I fix this by generating only a single dtd file with the
content merged from the multiple files. When I do that, all links work
as expected and no errors are generated.

2. I generate links to sections in the html documentation of tags inside
the comments that document a tag (using <a href="#tagname">tagname</a>
where tagname is somehow related to the current tag). It would be
nice if there was a meta tag (e.g. @link(tagname)) that would be
replaced by the appropriate hyperlink by dtddoc. That would be
especially helpful, if my first issue is fixed so that sometimes
@link(tagname) is replaced by a link to a different html file, when a
tag from a different dtd is referenced. generally, I want to avoid to
generate any html myself, if I can.

3. I would like to have some more flexibility for the table that is
generated for a tag's children. Currently, this seems to be restricted
to two columns : Name and Cardinality. It would be very nice to have an
optional third row maybe using the following in the dtddoc comment in

front of an element declaration:
<!--
@child childname some comment 1
@child childname2 some comment 2
-->
<ELEMENT xxx (childname|childname2)>

should generate:

xxx's childs

Name Cardinality Comment
childname Any some comment 1
childname2 Any some comment 2

If the @child is present, the "some comment" text could be placed in the
third column. This could also be configured as a global option to dtd,
including the name of the additional child table column (so that it is
not "Comment" but something else set in the general dtddoc options).

In my case, different child tags belong to different categories of tags
and expose different behavior depending on the category (e.g. some tags
must have certain attributes when used as a child tag, other tags do not
have this restriction).

Currently, I manually generate a 3 column table in the element dtddoc
comment, so that I can document this information. If a third row was
added to the child table, I would be able to use the default table
instead and could abstain from manual html generation.

For uniformity reasons, it probably would be good to also have an
optional third row for the attributes table as well, where I can place
some custom info.

Thanks for your help and providing a great tool,
Regards,
Alex

[Dtddoc-develop] Follow Up Get More Clients & Business

[<sh...@cm...>]

Hi,

Just wanted to check, have you checked my previous e-mail?

Do let me know if would like to discuss a Redesign/Re-Development of your website, SEO, Mobile Apps then I can send you our Past work details/Portfolio/Packages/Company information and time frame.

I look forward to hearing from you!

Regards,

Sharon 

Business Development Manager

From: Sharon [Sh...@cm...]

Subject: SEO Services & Website Re-Design!

___________________________________________________________________

Hi,

Are you willing to increase your revenue from online business..Or waiting to renovate your site with latest web trends? Do let us know… 

I would like to introduce us as an IT Service provider, with over 8 years of experience. We are headquartered in United States and has been partnering with various digital agencies over U.S., UK, Australia and Europe.



Our Offered Services are:-

Website Design & Development

Website Redesign

E- Commerce/Online Web Stores

Mobile website design

Mobile App Development

Digital Marketing Services (SEO, SMO, PPC)

Ongoing Web Maintenance



Kindly share your requirement for above mentioned services and we will get back to you with our best competitive plan.

We are also available for quick chat/call discussion on Skype/Phone.

Get in touch for more information.



Cheers!!

Kinds Regards,

Sharon,

[Dtddoc-develop] Get More Clients & Business

[<sh...@cm...>]

Hi,

Are you willing to increase your revenue from online business.. Or waiting to renovate your site with latest web trends? Do let us know… 



I would like to introduce us as an IT Service provider, with over 8 years of experience. We are headquartered in United States and has been partnering with various digital agencies over U.S., UK, Australia and Europe.



Our Offered Services are:-

Mobile App Development

Digital Marketing Services (SEO, SMO, PPC)

E- Commerce/Online Web Stores

Mobile website design

Ongoing Web Maintenance

Website Design & Development

Website Redesign



 If are you interested then I send you our Past work details/Portfolio/Packages/Company information and time frame. Kindly share your requirement for above mentioned services.

We are also available for quick chat/call discussion on Skype/Phone.

Get in touch for more information.



Kinds Regards,

Sharon,

Business Development Manager

[Dtddoc-develop] www.lists.sourceforge.net

[Anna | AU IT P. L. <ann...@gm...>]

Hello,


My name is Anna and I am a content writer . I stumbled on to your website  
and I thought it was very informative. If you are interested I would love  
to write a post for your website that I think your audience would really  
love.

I am happy to pay you some money to post my piece however I know you will  
be impressed with how informative and useful it is.

Please let me know if you like this post idea or if you would like me to  
write about something else and I can get started right away. Thanks!

Sincerely,

Anna

Content Management Expert


AU IT SOLUTIONS
Headquarters: 41 Bridge Rd Glebe, NSW 2037, Australia
Other Offices: Hong Kong & China | USA | New Zealand | UAE | Singapore

[Dtddoc-develop] www.lists.sourceforge.net

[Zara | C. P. L. <zar...@gm...>]

Hi There,

My name is Zara and I am Online Marketing Manager at a leading Aussie based  
digital marketing company which specialises in SEO (Google Rankings) and  
Web Design. We are your one-stop-shop for all Online Marketing and  
Advertising.

I was analysing your website and it seems that your website rankings have  
dropped on Google. It is due to non-optimised techniques / errors and  
Google guidelines not being met.

I would like to present a detailed analysis of your website along with  
errors that your website and ways to improve your Google rankings.

It would be a detailed report and would be explained as well on phone once  
we send this over to you.

Please let me know if you are interest in improving your website's ranking  
on Google.

In terms of pricing, our pricing structure is heavily dependent on the  
keywords you wish to target for your website and their current positions on  
Google. If you can send me a list of the keywords we can tailor a package  
and send you a detailed proposal outlining package inclusions and pricing  
along with a time frame for our services.

Look forward to your timely response

Best regards,

Zara | SEO Web Guru


CELLsIX
MEDIA PTY LTD.



Headquarters: Office 7003 X2 Tower, Cluster X, Melbourne Vic. 3000 Australia
Other Branches: Sydney | Perth | Brisbane | Adelaide | Hobart

[Dtddoc-develop] Furniture quote

[Jackie <Le...@wo...>]

Dear Boss,
 
 
How are you? Hope you have read our email before, we wish to hear from you.

We are chair and sofa factory locate in Foshan, Guangdong Province, China. Professional in seating furniture manufacturing, we can supply leather chair, fabric/mesh chair, banquet chair,  leather sofa, reclining sofa, fabric sofa, etc.  If you got orders of chair or sofa, we can quote you good price quickly, our production quality are very good also.

Reply this email to get our wholesale price list now, we can quote and produce your special design if with a certain order quantity. Welcome OEM inquiries.
 
 
Yours faithfully
Mr. Jackie
Mob：0086-18676512539
KANGYU FURNITURE CO.,LTD
Add:Baili Building,NO.1 Shangtang Yuxiu Road, Paisha Industrial Zone,Longjiang Town,Shunde District,Foshan City,Guangdong Prov.China.
Tel：0086-757-28682885   Fax：0086-757-28682887
Email：kys...@16...
Skype: kyseating

[Dtddoc-develop] www.lists.sourceforge.net

[Holley | webanalyticmedia.c. <hol...@gm...>]

Hi,

I recently browsed through your business website and wanted to highlight  
some key points for consideration.

I am sure it will complement your SEO work to help your website attract  
only quality visitors and make it scale high on the search engine results  
page (SERP) gradually.

Would you be interested in receiving the details?

Best regards,

Holley

SEO Guru

WAM(tm)

WEB ANALYTIC MEDIA

Headquarters: Office 7003 X2 Tower, Cluster X, Melbourne Vic. 3000 Australia
Branch Offices: Sydney | Perth | Brisbane | Adelaide | Hobart

PS: I hope you found this message to be useful. Do remember that further  
information that (if) you have requested is provided with absolutely  
No-Obligation. This mail has been sent based on your interest in our  
products/services during the last few days. However, if you'd rather not  
receive future e-mails of this sort, please reply with mail  
subject 'Remove'. I value your privacy & would never send unsolicited  
messages.

[Dtddoc-develop] www.lists.sourceforge.net

[Oliver C. <oc...@we...>]

<div dir="ltr"><span  
style="font-family:arial,sans-serif;font-size:13px">Hi,</span><br  
style="font-family:arial,sans-serif;font-size:13px"><br  
style="font-family:arial,sans-serif;font-size:13px"><span  
style="font-family:arial,sans-serif;font-size:13px">If you want your  
website to work harder, we can help you measure your performances, identify  
areas of weakness, and clear a path to better conversion rates. There's no  
single reason why visitors to your website fail to become customers. The  
need is to attract visitor's attention that helps in better  
interaction.  </span><br  
style="font-family:arial,sans-serif;font-size:13px">
<br style="font-family:arial,sans-serif;font-size:13px"><span  
style="font-family:arial,sans-serif;font-size:13px">Optimisation does not  
mean changing the existing layout of your website but these are tools for  
better visitor engagements. </span><br  
style="font-family:arial,sans-serif;font-size:13px">
<br style="font-family:arial,sans-serif;font-size:13px"><span  
style="font-family:arial,sans-serif;font-size:13px">Every non-converting  
visitor costs you in wasted marketing efforts and missed sale. </span><br  
style="font-family:arial,sans-serif;font-size:13px">
<br style="font-family:arial,sans-serif;font-size:13px"><span  
style="font-family:arial,sans-serif;font-size:13px">Would you be interested  
in receiving further information &amp; a quote for optimising your website  
with no-strings-attached?</span><p  
style="font-family:arial,sans-serif;font-size:13px">
<span face="Arial" style="font-family:Arial"><br></span></p><div  
style="font-family:arial,sans-serif;font-size:13px"><div dir="ltr"><span  
style="font-family:arial,helvetica,sans-serif">Best regards,<br><font  
color="#000000"><br>
</font></span><font color="#000000"><font face="Helvetica,  
sans-serif">Oliver Cowper | Director MKT<br></font></font><span  
style="font-family:arial,helvetica,sans-serif"><br></span><span  
style="font-family:georgia,serif;font-size:36pt;line-height:55.20000076293945px"><b><span  
style="color:rgb(255,0,102)">WAM</span></b></span><b  
style="font-family:georgia,serif"><span  
style="line-height:14.720000267028809px;color:rgb(255,0,102)"><font  
size="1">(tm)</font></span></b><span  
style="font-family:arial,helvetica,sans-serif"><br>
</span></div></div><div  
style="font-family:arial,sans-serif;font-size:13px"><span  
style="color:rgb(0,0,0);font-family:Verdana,sans-serif;font-size:10px"> <b>WEB  
ANALYTICS MEDIA</b><br><br>Headquarters: Office 7003 X2 Tower, Cluster  
X,</span><span  
style="color:rgb(51,51,51);font-family:Verdana,sans-serif;font-size:10px;line-height:18px"> </span><span  
style="color:rgb(51,51,51);font-family:Verdana,sans-serif;font-size:10px;line-height:18px">Melbourne  
Vic. 3000 Australia<br>
Website: <a href="http://www.webanalyticsmedia.com/"  
target="_blank">www.<WBR>webanalyticsmedia.com</a><br>Branch Offices:  
Sydney | Perth | Brisbane | Adelaide | Hobart<br><br></span><font  
color="#999999"><span  
style="font-family:arial,helvetica,sans-serif;font-size:x-small">Disclaimer: </span><span  
style="font-family:arial,helvetica,sans-serif;font-size:x-small">This  
e-mail is private and confidential. If you are not the intended recipient,  
please advise us by return e-mail immediately, and delete the e-mail and  
any attachments without using or disclosing the contents in any way. The  
views expressed in this e-mail are those of the author, and do not  
represent those of this company unless this is clearly indicated. You  
should scan this e-mail and any attachments for viruses. This company  
accepts no liability for any direct or indirect damage or loss resulting  
from the use of any attachments to this e-mail. All quotes received from  
Web Analytics Media by email are informal and not binding until a formal  
quote is agreed upon by both the parties.</span></font><span  
style="color:rgb(51,51,51);font-family:Verdana,sans-serif;font-size:10px;line-height:18px"><br>
</span></div><div><font color="#999999"><span  
style="font-family:arial,helvetica,sans-serif;font-size:x-small"><br></span></font></div></div>

[Dtddoc-develop] symlink bug

[D H. <my...@ya...>]

DTDDoc doesn't handle symlinked dtd files well. For example the content of my buildant.xml is given below.

However the dtd file that it references is actually a symlink to elsewhere on my drive. When it generates the documentation, it puts everything into a subfolder, which references the root node of my drive

So my project_doc directory contains a folder "home/user/work/svn/trunk/src/" & the HTML pages incorrectly use absolute references, so the HTML pages all have broken links.


<?xml version="1.0"?>

<project name="DTDDocAnt" default="main">

    <description>
    This file shows how to call DTDDoc from within Ant.
    It's an example for you :)
    </description>

    <!-- Tell ant where to find the code of the DTDDoc task.
         You may have to change this if the two jars are not in your
         path. -->

    <taskdef name="DTDDoc"
             classname="DTDDoc.DTDDocTask"
             classpath="DTDDoc.jar"/>

    <!-- Execute DTDDoc -->

    <target name="main">

        <!-- First, generate our own examples. -->

        <DTDDoc showHiddenTags="false"
                showFixmeTags="false"
                sourceDir="project"
                destDir="project_doc"
                docTitle = "project Documentation">
            <include name="**/*.dtd"/>
            <exclude name="common/*.dtd"/>
        </DTDDoc>

    </target>



</project>



      

[Dtddoc-develop] About DTDParser encoding patch

[Serkan K. <se...@ge...>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi all,

I'm trying to package dtddoc for Gentoo as a dependency of Jubler-4.0. I
just hit an error com.wutka.dtd.DTDParser.getDTDEncoding() being
missing. Reading the changelog, I got that you're using a patched
version of dtdparser. Is this patch sent to dtdparser upstream and
accepted to be included in the next release? If not can I access the
patch to test it for Gentoo?

Thanks in advance.
- --
Sincerely,
Serkan KABA
Gentoo/Java
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.9 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iEYEARECAAYFAklKvlUACgkQRh6X64ivZaJMeQCfXYqOcWkjSxPKyUXPtjI6uzXD
X9YAn2Do61VUC+nWJc/CgqdBjpkhFxLn
=Cc8G
-----END PGP SIGNATURE-----

Re: [Dtddoc-develop] Unable to parse DITA DTDs

[Stefan C. <sch...@sk...>]

 
> On Jan 23, 2008 2:35 PM, Stefan Champailler <sch...@sk...> wrote:
> > OK, tell us what you find.
> 
> Will do. I'm making a little progress, but like everyone else I'm
> trying to squeeze this in-between 100 or so other projects.

Looks like me (and add a child and a house to keep clean :))
> 
> > (sorry for this late answer ...)
> 
> That's okay, I know how it is. No worries!

Thank you for your time. It's very appreciated !

stF

> 
> Jason
> 
> -------------------------------------------------------------------------
> This SF.net email is sponsored by: Microsoft
> Defy all challenges. Microsoft(R) Visual Studio 2008.
> http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
> _______________________________________________
> Dtddoc-develop mailing list
> Dtd...@li...
> https://lists.sourceforge.net/lists/listinfo/dtddoc-develop
> 

-- 
Free software, free society

Re: [Dtddoc-develop] Unable to parse DITA DTDs

[Jason P. <st...@gm...>]

On Jan 23, 2008 2:35 PM, Stefan Champailler <sch...@sk...> wrote:
> OK, tell us what you find.

Will do. I'm making a little progress, but like everyone else I'm
trying to squeeze this in-between 100 or so other projects.


> (sorry for this late answer ...)

That's okay, I know how it is. No worries!

Jason

Re: [Dtddoc-develop] Unable to parse DITA DTDs

[Stefan C. <sch...@sk...>]

OK, tell us what you find.

Right now I don't have much time to look into your issue. Maybe Herv=E9 can=
 have=20
a look ?=20

(sorry for this late answer ...)

stF=20


> On Jan 8, 2008 3:33 PM, Stefan Champailler <sch...@sk...> wrote:
> > Thanks for the report !
> > Looks like we'll have to go deep in Wutka's DTDParser to solve th=E9at.=
 Will
> > take a while...
>=20
> I started digging myself, but its all new to me. If I can figure
> anything out I'll report back.
>=20
> Jason
>=20
> -------------------------------------------------------------------------
> Check out the new SourceForge.net Marketplace.
> It's the best place to buy or sell services for
> just about anything Open Source.
> http://ad.doubleclick.net/clk;164216239;13503038;w?http://sf.net/marketpl=
ace
> _______________________________________________
> Dtddoc-develop mailing list
> Dtd...@li...
> https://lists.sourceforge.net/lists/listinfo/dtddoc-develop
>=20

=2D-=20
=46ree software, free society

Re: [Dtddoc-develop] Unable to parse DITA DTDs

[Jason P. <st...@gm...>]

I logged this same report over on your project tracker on SF.net. Not
trying to be pushy ;)  I just wanted to be able to monitor this issue.
I don't know if you actually use your trackers thought.

Thanks again!

Jason



On Jan 8, 2008 3:33 PM, Stefan Champailler <sch...@sk...> wrote:
> Thanks for the report !
> Looks like we'll have to go deep in Wutka's DTDParser to solve th=E9at. W=
ill
> take a while...
>
>
> > Just an FYI - I am just trying DTDDoc for the first. It works great on
> > some simple DTDs I've got lying around (nice job!). Then I tried
> > generating documentation from the DITA (an OASIS standard, see
> > http://dita.xml.org/) DTDs, at which point DTDDoc choked.
> >
> > The error was:
> >
> >  [DTDDoc] ERROR: com.wutka.dtd.DTDParseException: URI topic.mod at
> > line 179, column 25: Invalid token in attribute declaration: CDATA
> >
> > Which seems to be caused by the contents of this entity:
> >
> > <!ENTITY % arch-atts "
> >              xmlns:%DITAArchNSPrefix;
> >                         CDATA                              #FIXED
> >                        'http://dita.oasis-open.org/architecture/2005/'
> >              %DITAArchNSPrefix;:DITAArchVersion
> >                         CDATA                              '1.1'"    >
> >
> > Jason
> >
> > -----------------------------------------------------------------------=
--
> > This SF.net email is sponsored by: Microsoft
> > Defy all challenges. Microsoft(R) Visual Studio 2005.
> > http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
> > _______________________________________________
> > Dtddoc-develop mailing list
> > Dtd...@li...
> > https://lists.sourceforge.net/lists/listinfo/dtddoc-develop
> >
>
> --
> Free software, free society
>
> -------------------------------------------------------------------------
> Check out the new SourceForge.net Marketplace.
> It's the best place to buy or sell services for
> just about anything Open Source.
> http://ad.doubleclick.net/clk;164216239;13503038;w?http://sf.net/marketpl=
ace
> _______________________________________________
> Dtddoc-develop mailing list
> Dtd...@li...
> https://lists.sourceforge.net/lists/listinfo/dtddoc-develop
>

Re: [Dtddoc-develop] Unable to parse DITA DTDs

[Jason P. <st...@gm...>]

On Jan 8, 2008 3:33 PM, Stefan Champailler <sch...@sk...> wrote:
> Thanks for the report !
> Looks like we'll have to go deep in Wutka's DTDParser to solve th=E9at. W=
ill
> take a while...

I started digging myself, but its all new to me. If I can figure
anything out I'll report back.

Jason

Re: [Dtddoc-develop] Unable to parse DITA DTDs

[Stefan C. <sch...@sk...>]

Hell Jason,

Thanks for the report !
Looks like we'll have to go deep in Wutka's DTDParser to solve th=E9at. Wil=
l=20
take a while...

stF=20


> Just an FYI - I am just trying DTDDoc for the first. It works great on
> some simple DTDs I've got lying around (nice job!). Then I tried
> generating documentation from the DITA (an OASIS standard, see
> http://dita.xml.org/) DTDs, at which point DTDDoc choked.
>=20
> The error was:
>=20
>  [DTDDoc] ERROR: com.wutka.dtd.DTDParseException: URI topic.mod at
> line 179, column 25: Invalid token in attribute declaration: CDATA
>=20
> Which seems to be caused by the contents of this entity:
>=20
> <!ENTITY % arch-atts "
>              xmlns:%DITAArchNSPrefix;
>                         CDATA                              #FIXED
>                        'http://dita.oasis-open.org/architecture/2005/'
>              %DITAArchNSPrefix;:DITAArchVersion
>                         CDATA                              '1.1'"    >
>=20
> Jason
>=20
> -------------------------------------------------------------------------
> This SF.net email is sponsored by: Microsoft
> Defy all challenges. Microsoft(R) Visual Studio 2005.
> http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
> _______________________________________________
> Dtddoc-develop mailing list
> Dtd...@li...
> https://lists.sourceforge.net/lists/listinfo/dtddoc-develop
>=20

=2D-=20
=46ree software, free society

[Dtddoc-develop] Unable to parse DITA DTDs

[Jason P. <st...@gm...>]

Just an FYI - I am just trying DTDDoc for the first. It works great on
some simple DTDs I've got lying around (nice job!). Then I tried
generating documentation from the DITA (an OASIS standard, see
http://dita.xml.org/) DTDs, at which point DTDDoc choked.

The error was:

 [DTDDoc] ERROR: com.wutka.dtd.DTDParseException: URI topic.mod at
line 179, column 25: Invalid token in attribute declaration: CDATA

Which seems to be caused by the contents of this entity:

<!ENTITY % arch-atts "
             xmlns:%DITAArchNSPrefix;
                        CDATA                              #FIXED
                       'http://dita.oasis-open.org/architecture/2005/'
             %DITAArchNSPrefix;:DITAArchVersion
                        CDATA                              '1.1'"    >

Jason

Re: [Dtddoc-develop] Documenting DTDs and their modules

[Yves F. (SRZ) <Y....@sr...>]

Herv=E9 a =E9crit:

> I don't completely understand your need: I don't understand how two "mo=
dules"=20
> can refer each other, since it represents a circular dependency.
> Can you provide us a simplified sample, with as much as possible proble=
ms you=20
> identified? This will help us to understand what can be done.

(Sorry for replying only today, I have been rather busy... setting up a=20
complex build system that involves DTDDoc (among other things). :-))

OK, I'll try to be more concise and at the same time clearer about the=20
problem. First, here is what it is NOT. A circular dependency would=20
result from modules (or DTDs) that *import* each other, like this:

-- file m1.dtd --
<!ENTITY % m2 SYSTEM "m2.dtd">
%m2;
--

-- file m2.dtd --
<!ENTITY % m1 SYSTEM "m1.dtd">
%m1;
--

In contrast to this, I am talking about modules that *refer* to each=20
other, or more precisely, refer to declarations in their contents.=20
(Parts of the main DTD act as modules in that sense, too, see example=20
below.) For instance:

-- file module0.mod --
<!ENTITY inline_elements "b|i">
--

-- file module1.mod --
<!ENTITY % module0 SYSTEM "module0.mod">
%module0;
<!ELEMENT mo1 (momo1|momo2)+>
<!ELEMENT momo1 (#PCDATA|%inline_elements;)*>
--

-- file module2.mod --
<!ENTITY % module0 SYSTEM "module0.mod">
%module0;
<!ELEMENT mo2 (momo1|momo2)+>
<!ELEMENT momo2 (#PCDATA|%inline_elements;)*>
--

-- file main.mod --
<!ENTITY % module1 SYSTEM "module1.mod">
%module1;
<!ENTITY % module2 SYSTEM "module2.mod">
%module2;
<!ELEMENT root (para|mo1|mo2)+>
<!ELEMENT para (#PCDATA|%inline_elements;)*>
<!ELEMENT b (#PCDATA)>
<!ELEMENT i (#PCDATA)>
--

As you can see, the modules cannot be used on their own but need to be=20
included in the main DTD because only the whole makes up a syntactically =

valid DTD. This is why I insist on calling them "modules" rather than=20
sub-DTDs.

The problem is: DTDDoc only has access to all declarations when it is=20
processing the main DTD, because DTDParser (seemingly) returns it with=20
the entities expanded.

The docs generated for the modules, however, will be broken because of=20
the "forward references" allowed by the DTD mechanism: element and=20
entity declarations may refer to elements which have not yet been=20
declared. In module 1, this is the case for the references to the=20
elements b, i and momo2.

As their declarations are not available in the current module, DTDDoc=20
cannot link to the element entry. Consequently, the HTML link to this=20
(child) element will be completely left out from the parent's content=20
model in the documentation for the module, so for element mo1 in module=20
1 it will look like "(momo1 | )", likewise the content model of momo1=20
will be shown as "(#PCDATA | | )".

So why generate documentation for the modules at all? Because they carry =

important information about their contents, and I need to keep it there
rather than including it into the main DTD's documentation.

In my last mail, I have hoped to give some ideas on how this problem=20
could be tackled (as far as I have understood the processes).

   Yves

Re: [Dtddoc-develop] Documenting DTDs and their modules

[<her...@fr...>]

Hallo Yves,

I don't completely understand your need: I don't understand how two "module=
s"=20
can refer each other, since it represents a circular dependency.
Can you provide us a simplified sample, with as much as possible problems y=
ou=20
identified? This will help us to understand what can be done.

Herv=E9

Le vendredi 02 novembre 2007, Yves Forkl (SRZ) a =E9crit :
> As far as I can see, DTDDoc's concept is to process a set of DTDs which
> are independent of each other, in the sense that their docs do not need
> to be linked. This does of course not prevent simple inclusion of one
> DTD in another, which would just lead to repeated descriptions of the
> included elements, attributes and entities.
>
> By contrast to this model, I am faced with the situation of having a DTD
> which includes a set of modules. Rather than just constituting sub-DTDs,
> these modules are interrelated among each other and of course with the
> main DTD which includes them. (For simplicity, I am assuming that there
> is no hierarchy of modules, each of them is just included in the main
> DTD.) "Interrelated" essentially means three things here:
>
> 1 - At the DTD-syntactical level, module A may contain a declaration for
> element a1 that references element b1 which is declared in module B.
> While the main DTD, after inclusion of the modules, disposes of both
> declarations, the modules themselves do not (and do not need to do so
> because they are just modules, not DTDs on their own).
>
> The effect of this is that when DTDDoc generates documentation for
> module A, the description of the content model of a1 will lack the
> complete link to b1, displaying a defective model like "(a2, , a3)"
> instead of the actual "(a2, b1, a3)", while the same description in the
> main DTD will be correct. The same applies of course to references in a
> module which rely on declarations occurring not in another module but in
> the main DTD.
>
> 2 - At the documentary level, each module has specific "global"
> information (purpose, version history etc.) aside the comments which
> accompany DTD-syntactical declarations. As a consequence, documentation
> must be generated not only for the whole DTD but for each module as
> well, because there is no reasonable other way to access this info
> (repeating it somehow in the main DTD is way too complicated: how to
> ensure it is transferred from the module? where to put it? how to access
> it?).
>
> 3 - The modules are logically related, and so is their documentation. At
> least, the documentation of a module may contain links to other parts of
> that same module's documentation. These links will be broken when the
> module is included together with its documentation into the main DTD.
>
> Problem No. 3 seems easiest to solve: it should suffice to include the
> name of the file generated by DTDDoc for the module's documentation in
> the links, i.e. to use "module_A.dtd.html#my_target" instead of just
> "#my_target" when putting links in the module's documentation comments.
> That will allow reaching the link destination from any DTD documentation
> file in the directory.
>
> The other two problems seem to be much more difficult to solve. Due to
> issue 2, I can't avoid to generate separate documentation for each of
> the modules. This means I have to deal with issue 1, i.e. avoiding links
> to element and attribute declarations from being broken because they
> reside in another module. These ideas came to my mind:
>
> A) For any module, have DTDDoc ignore any declarations because they
> might not be interpreted correctly (if referenced declarations are
> missing) and will be done with anyway in the main DTD (supposing that
> all modules are included there). This raises the problem of knowing what
> is a module and of changing DTDDoc's behavior accordingly, but would
> allow all links to element documentation, both generated by DTDDoc and
> set up manually, to target places in a single file, namely the main
> DTD's documentation file ("main.dtd.html").
>
> B) While parsing the DTD, take note of which module some declaration
> comes from, by examining the parameter entity references which are used
> for inclusion. When generating documentation for elements etc., draw on
> this info and
>
> - either build links for child elements etc. that correctly target the
> documentation file of the concerned module (or alternatively, always
> that of the main DTD)
>
> - or instead of creating a new documentation entry in the current
> module, just generate a cross-reference (a concept new to DTDDoc) to the
> documentation file of the module where the declaration originates from.
>
>
> What do you think about this? Do you have any suggestion how to document
> DTDs and their modules while assuring that this does not break the links?
>
> Yours,
>
>    Yves
>
> -------------------------------------------------------------------------
> This SF.net email is sponsored by: Splunk Inc.
> Still grepping through log files to find problems?  Stop.
> Now Search log events and configuration files using AJAX and a browser.
> Download your FREE copy of Splunk now >> http://get.splunk.com/
> _______________________________________________
> Dtddoc-develop mailing list
> Dtd...@li...
> https://lists.sourceforge.net/lists/listinfo/dtddoc-develop

[Dtddoc-develop] Documenting DTDs and their modules

[Yves F. (SRZ) <Y....@sr...>]

As far as I can see, DTDDoc's concept is to process a set of DTDs which 
are independent of each other, in the sense that their docs do not need 
to be linked. This does of course not prevent simple inclusion of one 
DTD in another, which would just lead to repeated descriptions of the 
included elements, attributes and entities.

By contrast to this model, I am faced with the situation of having a DTD 
which includes a set of modules. Rather than just constituting sub-DTDs, 
these modules are interrelated among each other and of course with the 
main DTD which includes them. (For simplicity, I am assuming that there 
is no hierarchy of modules, each of them is just included in the main 
DTD.) "Interrelated" essentially means three things here:

1 - At the DTD-syntactical level, module A may contain a declaration for 
element a1 that references element b1 which is declared in module B. 
While the main DTD, after inclusion of the modules, disposes of both 
declarations, the modules themselves do not (and do not need to do so 
because they are just modules, not DTDs on their own).

The effect of this is that when DTDDoc generates documentation for 
module A, the description of the content model of a1 will lack the 
complete link to b1, displaying a defective model like "(a2, , a3)" 
instead of the actual "(a2, b1, a3)", while the same description in the 
main DTD will be correct. The same applies of course to references in a 
module which rely on declarations occurring not in another module but in 
the main DTD.

2 - At the documentary level, each module has specific "global" 
information (purpose, version history etc.) aside the comments which 
accompany DTD-syntactical declarations. As a consequence, documentation 
must be generated not only for the whole DTD but for each module as 
well, because there is no reasonable other way to access this info 
(repeating it somehow in the main DTD is way too complicated: how to 
ensure it is transferred from the module? where to put it? how to access 
it?).

3 - The modules are logically related, and so is their documentation. At 
least, the documentation of a module may contain links to other parts of 
that same module's documentation. These links will be broken when the 
module is included together with its documentation into the main DTD.

Problem No. 3 seems easiest to solve: it should suffice to include the 
name of the file generated by DTDDoc for the module's documentation in 
the links, i.e. to use "module_A.dtd.html#my_target" instead of just 
"#my_target" when putting links in the module's documentation comments. 
That will allow reaching the link destination from any DTD documentation 
file in the directory.

The other two problems seem to be much more difficult to solve. Due to 
issue 2, I can't avoid to generate separate documentation for each of 
the modules. This means I have to deal with issue 1, i.e. avoiding links 
to element and attribute declarations from being broken because they 
reside in another module. These ideas came to my mind:

A) For any module, have DTDDoc ignore any declarations because they 
might not be interpreted correctly (if referenced declarations are 
missing) and will be done with anyway in the main DTD (supposing that 
all modules are included there). This raises the problem of knowing what 
is a module and of changing DTDDoc's behavior accordingly, but would 
allow all links to element documentation, both generated by DTDDoc and 
set up manually, to target places in a single file, namely the main 
DTD's documentation file ("main.dtd.html").

B) While parsing the DTD, take note of which module some declaration 
comes from, by examining the parameter entity references which are used 
for inclusion. When generating documentation for elements etc., draw on 
this info and

- either build links for child elements etc. that correctly target the 
documentation file of the concerned module (or alternatively, always 
that of the main DTD)

- or instead of creating a new documentation entry in the current 
module, just generate a cross-reference (a concept new to DTDDoc) to the 
documentation file of the module where the declaration originates from.


What do you think about this? Do you have any suggestion how to document 
DTDs and their modules while assuring that this does not break the links?

Yours,

   Yves