* Verbatim modules @ 2002-02-21 12:07 Robert F. Beeger 2002-02-25 15:32 ` Hans Hagen 0 siblings, 1 reply; 6+ messages in thread From: Robert F. Beeger @ 2002-02-21 12:07 UTC (permalink / raw) [-- Attachment #1: Type: text/plain, Size: 1806 bytes --] Hello! I searched for a possibility to include listings with syntax highlighting in my current text. First I thought it would be nice to embed HTML in ConTeXt since my Java-IDE can export Java-Files with syntax highlighting to HTML. Then I found the verbatim modules of ConTeXt and think they are a much better idea. It is more lightweight than having the HTML-export with all those font settings and so on. Those verbatim modules do nearly everything I need. Thanks to Pragma ADE for this. But now I have some questions. There are is a JS and a JV verbatim environment defined in ConTeXt. What is the difference between those two. Is it only to make the intention clear : If you have some Java-code, use JV to make clear that it is Java and not JavaScript. If it is JavaScript use JS. Or is there more to it. I have one problem with the Java/JavaScript verbatim module. I would like the comments to be grayed out like it is done by the XML module. If I have \startJV // bla public void bla(); \stopJV the "//" gets typeset in red and the "bla" after the "//" gets typeset in black, which is the normal color for non-keywords. How do I make it that the "bla" after the "//"is grayed out. An other problem occurres when I use a JavaDoc-Comment \startJV /** * bla * @param blub Blub bla blub. */ \stopJV Now "/*" and "*/" gets typeset in red, the "*" after "/*" and the text in the comment gets typeset in black and the two remaining "*" get grayed out. Here I would like to have "/*", "*/" and the other stars to be typeset in one color´, be it red or what ever, and the text to be grayed out. I know this is not that easy to accomplish and is more a feature request for the future. But since I am into this now, I thought it would not do any harm, if mentioned it. Greets Robert [-- Attachment #2: S/MIME Cryptographic Signature --] [-- Type: application/x-pkcs7-signature, Size: 1992 bytes --] ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Verbatim modules 2002-02-21 12:07 Verbatim modules Robert F. Beeger @ 2002-02-25 15:32 ` Hans Hagen 2002-02-25 21:35 ` Re[2]: " Giuseppe Bilotta 2002-02-27 7:52 ` Robert F. Beeger 0 siblings, 2 replies; 6+ messages in thread From: Hans Hagen @ 2002-02-25 15:32 UTC (permalink / raw) Cc: ntg-context At 01:07 PM 2/21/2002 +0100, Robert F. Beeger wrote: >There are is a JS and a JV verbatim environment defined in ConTeXt. >What is the difference between those two. Is it only to make the >intention clear : If you have some Java-code, use JV to make clear >that it is Java and not JavaScript. If it is JavaScript use JS. Or is >there more to it. no, as you deduced, theye're just synonyms >I have one problem with the Java/JavaScript verbatim module. I would >like the comments to be grayed out like it is done by the XML module. > >If I have > >\startJV >// bla >public void bla(); >\stopJV > >the "//" gets typeset in red and the "bla" after the "//" gets typeset in >black, which is the normal color for non-keywords. >How do I make it that the "bla" after the "//"is grayed out. > >An other problem occurres when I use a JavaDoc-Comment > >\startJV > /** > * bla > * @param blub Blub bla blub. > */ >\stopJV > >Now "/*" and "*/" gets typeset in red, the "*" after "/*" and the text >in the comment gets typeset in black and the two remaining "*" get >grayed out. Here I would like to have "/*", "*/" and the other stars >to be typeset in one color´, be it red or what ever, and the text to >be grayed out. I know this is not that easy to accomplish and is more a >feature request for the future. But since I am into this now, I >thought it would not do any harm, if mentioned it. if you give me precise specs and example files, i can have a look at it Hans ------------------------------------------------------------------------- Hans Hagen | PRAGMA ADE | pragma@wxs.nl Ridderstraat 27 | 8061 GH Hasselt | The Netherlands tel: +31 (0)38 477 53 69 | fax: +31 (0)38 477 53 74 | www.pragma-ade.com ------------------------------------------------------------------------- fall-back web server: www.pragma-pod.nl ------------------------------------------------------------------------- ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re[2]: Verbatim modules 2002-02-25 15:32 ` Hans Hagen @ 2002-02-25 21:35 ` Giuseppe Bilotta 2002-02-26 11:01 ` Hans Hagen 2002-02-27 7:52 ` Robert F. Beeger 1 sibling, 1 reply; 6+ messages in thread From: Giuseppe Bilotta @ 2002-02-25 21:35 UTC (permalink / raw) Cc: ntg-context Monday, February 25, 2002 Hans Hagen wrote: HH> At 01:07 PM 2/21/2002 +0100, Robert F. Beeger wrote: >>There are is a JS and a JV verbatim environment defined in ConTeXt. >>What is the difference between those two. Is it only to make the >>intention clear : If you have some Java-code, use JV to make clear >>that it is Java and not JavaScript. If it is JavaScript use JS. Or is >>there more to it. HH> no, as you deduced, theye're just synonyms And they shouldn't be! I believe JV should be kept for Java ("real" Java). -- Giuseppe "Oblomov" Bilotta ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re[2]: Verbatim modules 2002-02-25 21:35 ` Re[2]: " Giuseppe Bilotta @ 2002-02-26 11:01 ` Hans Hagen 0 siblings, 0 replies; 6+ messages in thread From: Hans Hagen @ 2002-02-26 11:01 UTC (permalink / raw) Cc: ntg-context At 10:35 PM 2/25/2002 +0100, Giuseppe Bilotta wrote: >Monday, February 25, 2002 Hans Hagen wrote: > >HH> At 01:07 PM 2/21/2002 +0100, Robert F. Beeger wrote: > > >>There are is a JS and a JV verbatim environment defined in ConTeXt. > >>What is the difference between those two. Is it only to make the > >>intention clear : If you have some Java-code, use JV to make clear > >>that it is Java and not JavaScript. If it is JavaScript use JS. Or is > >>there more to it. > >HH> no, as you deduced, theye're just synonyms > >And they shouldn't be! I believe JV should be kept for Java >("real" Java). i know, but the highlighting is the same (and also quite similar to the perl one) of course you can have two similar copies and fool yourself -) Hans ------------------------------------------------------------------------- Hans Hagen | PRAGMA ADE | pragma@wxs.nl Ridderstraat 27 | 8061 GH Hasselt | The Netherlands tel: +31 (0)38 477 53 69 | fax: +31 (0)38 477 53 74 | www.pragma-ade.com ------------------------------------------------------------------------- fall-back web server: www.pragma-pod.nl ------------------------------------------------------------------------- ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re[2]: Verbatim modules 2002-02-25 15:32 ` Hans Hagen 2002-02-25 21:35 ` Re[2]: " Giuseppe Bilotta @ 2002-02-27 7:52 ` Robert F. Beeger 2002-02-27 23:09 ` Hans Hagen 1 sibling, 1 reply; 6+ messages in thread From: Robert F. Beeger @ 2002-02-27 7:52 UTC (permalink / raw) Cc: ntg-context [-- Attachment #1.1: Type: text/plain, Size: 3085 bytes --] Hello, Hans! Monday, February 25, 2002, 4:32:40 PM, Hans Hagen wrote >>Now "/*" and "*/" gets typeset in red, the "*" after "/*" and the text >>in the comment gets typeset in black and the two remaining "*" get >>grayed out. Here I would like to have "/*", "*/" and the other stars >>to be typeset in one color´, be it red or what ever, and the text to >>be grayed out. I know this is not that easy to accomplish and is more a >>feature request for the future. But since I am into this now, I >>thought it would not do any harm, if mentioned it. HH> if you give me precise specs and example files, i can have a look at it Well, let's try this: In Java there are three sorts of comments. The first one is the one-line-comment and is introduced with "//" as in // This is an assignment a = 78 The second one can be used to make a multi-line comment. It is started with a "/*" and finished with a "*/" as in /* This is a multi-line comment. Really! */ Those first two sorts of comments are also available in JavaScript, C and C++. The third one is a speciality of Java. It is used to produce JavaDoc-Comments. A tool, called JavaDoc, recognizes these comments and generates an API-documentation from those comments. JavaDoc-comments are used just before the definition of - a class to describe what the class is for and show some simple examples of how to use it. - a method to describe what the method is for, to describe what the meaning of the arguments is and to show simple examples of the usage of the method. - a field to (guess what) describe the field is for. A JavaDoc-comment is started by a "/**". Each line in a JavaDoc-comment begins with a "*". A JavaDoc-comment is finished by a "*/". An example /** * This method adds to integers. * * @param a first number * @param b second number */ public int sum(int a, int b); Although a JavaDoc-comment may contain some @-keywords and although some IDEs highlight them differently, it would be to much for a ConTeXt-document to also have them highlighted differently. That would be to much eye-candy. Just highlighting the whole contents of a JavaDoc-comment would be sufficient. JavaDoc-comments use HTML for the formatting. The JavaDoc-tool generates the API-documentation in HTML, so the formatting instructions in a JavaDoc-comment are used directly in the resulting documentation. But this also should not have any consequence for the highlighting in ConTeXt. There are two kinds of highlighting a Java-comment that would look good and make it clear that it's a comment - Highlight all of the comment including the markers "//", "/*", "/**", "*" and "*/" in the same color. - Highlight the markers and the contents differently. This would bring a difficulty into it. It would be necessary to differentiate between the "*" at the start of a JavaDoc-comment-line and a "*" that appears somewhere in the body of the comment as in /** * 2 * 2 = 4 */ I would be glad with the first variant, but ConTeXt seems to use the second one. As a sample I have included a Java-class. Does this help? -- Greets Robert [-- Attachment #1.2: LoginServlet.java --] [-- Type: application/octet-stream, Size: 1214 bytes --] package de.jwamalpha.handling.web.rbdipl; import java.io.IOException; import java.io.PrintWriter; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.servlet.ServletException; /** * The simple login servlet * * @history * @modification 25-jan-2002, v1.00, Robert F. Beeger * Development. * @history-end */ public class LoginServlet extends HttpServlet { // // public interface // /** * Process the get-request. * * @param request the request * @param response the response. */ protected void doGet (HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { response.setContentType("text/html"); PrintWriter writer = response.getWriter(); writer.println("<html>"); writer.println(" <head>"); writer.println(" <title>Login</title>"); writer.println(" </head>"); writer.println(" <body>"); writer.println(" Hallo, Benutzer " + request.getParameter("username") + "!"); writer.println(" </body>"); writer.println("</html>"); writer.flush(); } } [-- Attachment #2: S/MIME Cryptographic Signature --] [-- Type: application/x-pkcs7-signature, Size: 1992 bytes --] ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re[2]: Verbatim modules 2002-02-27 7:52 ` Robert F. Beeger @ 2002-02-27 23:09 ` Hans Hagen 0 siblings, 0 replies; 6+ messages in thread From: Hans Hagen @ 2002-02-27 23:09 UTC (permalink / raw) Cc: ntg-context Hi, I'll send you the patched files in a separate mail. (javadoc handling with @tag colorization); please check the lists at the end of verb-jv since i am (and wanna be) happily unaware of them Hans ------------------------------------------------------------------------- Hans Hagen | PRAGMA ADE | pragma@wxs.nl Ridderstraat 27 | 8061 GH Hasselt | The Netherlands tel: +31 (0)38 477 53 69 | fax: +31 (0)38 477 53 74 | www.pragma-ade.com ------------------------------------------------------------------------- fall-back web server: www.pragma-pod.nl ------------------------------------------------------------------------- ^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2002-02-27 23:09 UTC | newest] Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2002-02-21 12:07 Verbatim modules Robert F. Beeger 2002-02-25 15:32 ` Hans Hagen 2002-02-25 21:35 ` Re[2]: " Giuseppe Bilotta 2002-02-26 11:01 ` Hans Hagen 2002-02-27 7:52 ` Robert F. Beeger 2002-02-27 23:09 ` Hans Hagen
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).