« first day (1271 days earlier)      last day (3653 days later) » 

2:35 AM
Some advice please?
 
3:01 AM
What do you want advice regarding aliteralmind?
 
3:35 AM
Is there a better way to model some entity (say a topic of user's interest) other than using a primitive int? There isn't anything important to do with them but to simply enumerate them and distinguish one from another. I can't use Java enum because I don't know how many topics I will have.
 
4:09 AM
@jimmycarr: Didn't know you responded :)
I'm writing a library for automating the insertion of (already unit-tested) example code into JavaDoc. I've reached a crossroads and I want to make sure I'm not missing a huge need before continuing. It provides for presenting (a) the source code (with customizations such as JavaDoc-linking function names, eliminating irrelevant or unwanted sections [like the license block, etc]),
and (b) its System.out/console output. Is there something else that is an obvious omission here? Just source-code and console output. Anything else?
@Sudhi: I think a lot more context of your problem would help. Distinguishing objects with ids generally implies a design problem.
 
4:31 AM
@aliteralmind I am writing a simulation of simple social network where user generates content with certain topic and other users read them. As this is simulation I don't care what the nature of the topic is or what the actual content is. I just want to generate bunch of contents for a given set of topics and make other users read them. Of course, I should be able to distinguish a content from one topic to another but I don't want to compare or perform other meaningful algebraic operations on them.
The closest I could think of was an enum but then I will have to add meaningless words like topic1 to the enum set and use them everywhere. I hacked out the first draft of the code with ints and now I am wondering how to proceed.
 
How about a Map<String,List<String>>, where the key is the topic description, and the value is all messages related to it. This map would be a secondary view of te topics, I would think, which would primarily in a time/date-ordered list, or similar.

Does that work?
A secondary view of the messages (content) I meant to say.
 
4:50 AM
@aliteralmind Umm, you see, I don't want to model the topic description or other "real world" things. This is a short simulation project and the simulation engine doesn't really care about the topic of the content. It just needs to know "hey this bunch of content is for this one particular topic, let me asks that bunch of users who are interested in it to read them." The entire thing is simulated (including the act of user reading a content)
So its kinda overkill to use String for me. Imagine doing the simulation for thousands of users with hundreds of topics over millions of simulation steps
The current implementation works just fine with int, but I think this is more of a design problem which doesn't really have an objective "this is the correct" solution answer. What do you think?
 
Honestly, I'm not sure, then. :(
 
5:04 AM
Its OK. I think I shouldn't worry about it now. When time comes, it will become more clear what I need to use. I am just scary of autoboxing the int into Integer. I don't consider myself to be proficient in java.lang (yet)
 
Java people... i need a very simple help.I got two lists.. i want to check if List 2 contains all the items of list 1.Note that List 1 may have extra values too and the elements are actually string.
 
fge
5:26 AM
@Nezam: a quick peek at the javadoc (you do have a link open to it, right?) can give you the answer here; namely, that List has a .containsAll() method
 
@fge THANK YOU SO MUCH
 
fge
@Nezam but keep a link to the JDK javadoc at hand
Saves you a lot of time
 
@fge you're right
 
any one worked on Storm framework ? ?
 
 
8 hours later…
1:44 PM
Good morning, Java!
@fge What comments?
 
fge
@Michael about your breaking the contains contract
 
@fge How am I breaking it?
 
fge
@Michael in your Forwarding* you systematically cast the argument to a String; however this means you get a ClassCastException if the argument is not a String
And this is not allowed as per Collection#contains()
 
@fge I fixed that.
 
fge
Ah
Didn't see, sorry ;)
 
1:53 PM
I check to see if the Object is a String with instanceof, then cast it.
No problem.
 
fge
@Michael do not hesitate if you want... Err... "pedantic" reviews ;) I am unfortunately quite good at that
 
@fge By all means, go crazy. xD
 
fge
And I think I'm going to wager 500 rep again for that rhino problem :/
 
Rhino problem?
 
fge
Can only bounty start tomorrow but I'll do
I want to understand what on earth is happening here
And Google didn't help one bit
Moreover, efficient usage of Rhino is a surprisingly scarce topic in general
I am sure my code can be way better than it is
 
2:05 PM
@fge Maybe you can't define any new functions if you seal the context?
 
fge
@Michael as I said, it is the first time I see this exception; I cannot reproduce it at all
It has always worked so far
But not for this guy
(hmm, I say "as I said", maybe this is not that clear in the question, is it?)
 
So it works for you, but not for the other guy.
 
fge
Well, it works for n people where n seems to be "all people using my library except this guy"
 
Is he using a different version of Rhino?
 
fge
He says no... I have asked him to describe his environment a little more but no answer so far; he also pretends that no other library than mine pulls that dependency in
I am more and more inclined to believe that he is lying, consciously or not, and that another component of his does the same thing as me, except it is loaded before me
 
2:09 PM
The error message says you are trying to add a property to an object, but you are not doing that at all.
 
fge
And that would explain why I get this error
Well yes, I don't see a name at all; or maybe the name is ""
 
Unless it considers function definitions to be adding a property to some global object.
 
fge
Yup, that is another problem
Frankly, it eludes me at the moment
And I cannot for the life of me find good, explanative Rhino documentation
(as to why I don't use ScriptEngine, simple: it performs 20 times worse than Rhino for that simple task)
I looked around for an ECMA 262 regex library as well, but no dice
So I resorted to Rhino, which does... It has to, otherwise it wouldn't be able to pretend it was "JavaScript for Java"
And I don't want to write one; I just don't have the necessary skills
 
So you are using Rhino for its ECMA 262 regex library.
Why can't you use Java's regex functionality?
 
fge
Because ECMA 262 regexes aren't Java regexes
Example: a++ is legal in Java, not in ECMA 262; [^] is legal in ECMA 262, not in Java.
And I want strict conformance ;)
 
2:20 PM
Why would you want to use [^]?
 
fge
This is also why I wrote in the spec that you should restrict yourself to certain tokens when using regexes as well (yes, I am the author of two of the three JSON Schema IETF draft)
Meh, go figure; anyway I don't want to fail schema validation just because a guy uses that (mistakenly or not)
Also, for instance, ECMA 262 has no support for lookbehinds
 
Why not?
 
fge
Its definition of \b differs from Java's, so does the dot etc
Don't know, ask ECMA ;)
 
Dang, that seems like a fairly big deal xD
 
fge
Well, most people won't care. I do ;)
 
2:23 PM
haha
 
fge
I believe I have the only implementation today passing all "torture tests" from the JSON Schema test suite
And that includes arbitrarily large number support
And correct calculation of JSON String lengths too!
 
Nice.
 
fge
In the same way I also have one of the very few fully compliant implementations of URI Templates in Java -- if not the only one
Meh
I just don't like to leave things unfinished
 
Cool
What's a URI template?
 
fge
But I suck at GUIs... I intend to write one in a few months and I'll be sure to model it on your way of doing things; the pattern is really nice
 
2:35 PM
Thanks :D
 
fge
Well, for instance, say you have http://foo.bar/some/path{?queryparams*}
And queryparams is an associative array: hello -> world, answer -> 42
 
Right.
 
fge
Expanding this would give http://foo.bar/some/path?hello=world&answer=42
Now, the associative array values may contain spaces etc
The goal is to obtain a URI which is always valid
 
I thought URIs couldn't contain spaces
They have to be encoded as %20.
 
fge
Another example: http://foo/bar/{/pathelements*}
No they can't, and they are
And pathelements is an array containing [ "el1", "with spaces" ]
Expanding that would give http://foo.bar//el1/with%20spaces
 
2:39 PM
Ok
 
fge
All in all it allows you to add "variables" into URIs
Either single scalars, arrays, or what they call "associative arrays" (maps, in fact)
That is RFC 6570
It is immensely useful for REST APIs
 
Yeah, I thought I saw something like this in Jersey.
 
fge
Uh, not really
Jersey does parsing
 
So you can do something like: http://example.com/{folder}
 
fge
For instance you can @Path("/foo/{myId}")
 
2:41 PM
And then, you can extract whatever part of the URL is defined by {folder}
@fge Exactly.
 
fge
Yes, that is parsing, not expanding
URI templates is about expansion
 
What is expanding then?
 
fge
Well, what I said
You provide the template, you provide the variables
 
Ah, the reverse.
 
fge
And you get the expanded text
Which may OR MAY NOT be a valid URI or URL in the end -- the RFC makes no guarantee about that
 
2:42 PM
But shouldn't it be?
 
fge
Up to the user to write the correct template ;)
Eh, no, how do you want to ensure that?
 
I see.
I mean in terms of properly encoding special characters and the like.
 
fge
Well, this is the responsibility of the expansion process
Ie, the implementation
What isn't is the responsibility of writing a template which actually makes sense when expanded
 
Ah.
 
fge
For instance you have the + modifier; it will expand according to what characters should be escaped in a fragment part
That includes the + character itself for instance
 
2:45 PM
What is the difference between + and %20?
 
fge
So, if you write http://foo.bar/{+value}, this is a legal template, you can expand it, but if there is a + in value the resulting URI is invalid, since there cannot be a + in a path element
Well, different encoding rules
Which is why URLEncoder.encode() does not work for URI elements ;)
The latter performs encoding for form data
 
Ah, so + represents a space character in form data, and %20 represents a space character in URIs.
 
fge
And in form data encoding (ie, application/x-www-form-urlencoded), the space becomes a +
 
Ah ok.
 
fge
Different rules, different processes ;)
Guava has UrlEscapers which partly do the job for URIs
(starting with version 15.0)
 
2:48 PM
Partly?
 
fge
Well, you can encode what RFC 6570 calls scalar values
But that is all (OK, it's already 85+% of usages)
 
What's scalar value?
 
fge
A single value
As opposed to an array and a map
 
Ah ok.
 
fge
Still, it's better than URLEncoder.encode()
And one more reason to use Guava :p
 
2:52 PM
So Guava properly escapes spaces for URIs.
 
fge
UrlEscapers.urlPathSegmentEscaper() does, yes
Escaper is super powerful
I just wish there were Unescaper too
 
Do you need a different escaper for query params?
 
Opinions/advice please? When displaying example code in your JavaDoc, is there anything more than its source-code and System.out / console output?
I'm writing a library to automate this insertion (with lots of customization options), for example code that's ideally already been unit tested.
 
@aliteralmind It helps to provide an example of how to use the class.
 
fge
@Michael RFC 3986 says no
Same grammar
It only differs for URI fragments
 
2:58 PM
@fge So why have a "urlPathSegmentEscaper()" and not a "urlEscaper()"
 
fge
@Michael because it differs for fragments
You can see that there is also a urlFragmentEscaper()
But I believe there is a subtle-but-there difference between URLs and URIs here; I have tried actually to use those instead of my custom Escaper and it failed on some tests
Cannot remind the difference, don't care, mine works
;)
@aliteralmind where do you extract that example code from?
 
@Micheal: I don't think I'm being clear. I'm not asking for programming advice, I'm worried I've missed a potential feature and I'm at the point where I'm about to either eliminate the possibility (of something other than source code or output), or about four days of work to ensure additional capabilities are possible. I can certainly provide a taste of how to use the library if you still think that's needed.
 
fge
@Michael note that this difference doesn't prevent a valid URI from being a valid URL, so it is safe
@aliteralmind of course it's needed ;)
 
@fge: From fully working, stand-alone Java classes. Such as DemonstrateMyClass.java
 
fge
@aliteralmind I could use something like that
@aliteralmind and I'd love to have an example "automagically inserted" for me with a single tag
@aliteralmind right now I write examples in a separate package and refer to them, but it's not ideal
 
3:03 PM
@aliteralmind Just provide a code sample in your Javadocs. The user can create their own test class if they want.
 
Okay, so give me a minute and I'll give you a taste.
 
fge
@aliteralmind along with a link to the project, meh
@aliteralmind also, not sure whether that can help you but are you aware of Java 8's new DocTree API?
 
Hello Java
 
Meanwhile, answer this: When you display example code (regardless if you just paste it directly or link to it), do you ever show anything more than its source-code and console output?
 
Hi @Karl
@aliteralmind Like what?
 
3:07 PM
@Michael: Exactly my question. And if that is your answer, it's exactly the one I was hoping for: No. Only source-code and console output.
 
Good morning java
 
fge
@aliteralmind depends on the situtation but I can see where this is going and I quite like it
@aliteralmind in fact, all of my examples are main()s
So, having the possibility to preprocess that in Javadoc, yes
 
Hi @GustavoSuarez
 
fge
@aliteralmind example?
youtube.com/watch?v=C_QbkGU_lqY <-- very interesting video
(yes, it's about Java)
And the presenter is none other than the author of "Java: Concurrency In Practice"
 
Cool.
I was at a presentation yesterday about garbage collection in Java.
Most garbage collection implementations use a "stop the world" algorithm, which means that the VM has to pause the program in order to run the garbage collector.
For small amounts of memory (2-4GB) the pause isn't too noticable. But as you add more and more memory, the pause gets longer.
But the presenter's company has a VM that does concurrent garbage collection, so pauses aren't nearly as long.
The VM is called Zing.
Off to lunch, cya.
 
3:37 PM
@fge, @Michael: Ok, here you go. It's just a text file of the basics. It's called XBN-Java:Insert Example code (IXC). pastebin.com/ybpnY6CU
 
fge
@aliteralmind uhm, that would have been much more convenient had this been a doclet tag
 
Lay it on me. How?
@fge: Would that limit the example code (and its output) to only being displayed at the bottom of each JavaDoc block? I'm writing package-info.java documentation where there's a whole lot of IXC-blocks throughout, not just at the bottom.
Perhaps an optional way of using it via a doclet tag?
 
fge
3:53 PM
Eh, not sure
I know you can create your own doclets -- though that requires to define the doclet implementation you use when creating javadoc
 
@fge: Oh! You mean something like {@xmplsource com.github.xbn.examples.SomeExampleCode}?
 
fge
Yes
Which would do everything for you
That is worth a project of its own
(imho)
And rename that to exampleSource ;) xmpl requires... Well... Interpretation ;)
 
Yes yes displaySourceCode is a better name.
` [([EXAMPLE-CODE-START:com.github.xbn.examples.insertexample.adder.AdderDemo#main()
<PRE>[[source:getAllSourceLines_tabTo3Spcs_escForHtml_withIndent(" ")]]</PRE>

<P><B>Output:</B></P>

<PRE> [C:\java_code\]java %fqclassname%
[[output:getAllOutputLinesWithIndent(" ")]]</PRE>
:EXAMPLE-CODE-END])]`
But how do you configure all of these things into one/a few JavaDoc taglets?
 
fge
Can't remember; I just remember that you can do that
 
The [[source:processorFunction(its, parameters)]] gap refers to the fully-qualified example code, as configured above it.
@fge: I don't know... The [([EXAMPLE-CODE-START:com.github.xbn.examples.insertexample.adder.AdderDemo#mai‌​n() ... :EXAMPLE-CODE-END])]construct makes it pretty clear that everything in that block refers to the AdderDemoclass. Having separate and seemingly-unrelated taglets would make that relationship less clear, don't you think?
You'd have to do something like {@exampleCodeStart com.github.xbn.examples.insertexample.adder.AdderDemo#main()} ... {@displayExampleSource processor=getAllSourceLines_tabTo3Spcs_escForHtml_withIndent(" ")} ... {@exampleCodeFullyQualifiedName} ...
You like that better?
 
fge
4:10 PM
@aliteralmind what I'd really like is @demoClass package.to.class.TheClass, and that would insert both the code and sample output; requirements would be that TheClass defines main and prints to stdout/stderr which you would capture
Simple requirements, big effects ;)
 
@fge: Okay, I understand that.
As an additional option, is the IXC-block okay? Or in your opinion, does that need to change to inline taglets?
 
fge
Not sure what you mean by IXC block here
 
IXC-block: [([EXAMPLE-CODE-START:com.github.xbn.examples.insertexample.adder.AdderDemo#mai‌​‌​n() ... :EXAMPLE-CODE-END])]
 
fge
Consider this: if you want this in the javadoc, what is the more natural?
 
Okay. So how about JavaDoc linking function names with @demoClass package.to.class.TheClass? Just not important?
 
fge
4:15 PM
As I say I'd love that
 
So how would you specify which functions link to where?
 
fge
No idea where the surrounding curly braces have gone, but "{@demoClass package.to.class.TheClass}" which would 1. inline the code, 2. run main() and paste the output would be great
 
I thought you were talking about not inline.
 
fge
No actually, I do want to inline in this case
Or provide a relative link to the source
But have the output
OK, it's not easy to do, I admit
But that'd be awesome to have
 
4:29 PM
@fge: Okay, so is this good?
- Default, with no JavaDoc links or customization
{@displaySourceCode my.package.AdderDemo}
- To specify command-line parameters:
{@displaySourceFor my.package.AdderDemo(5, -10, true, "name")}
- To specify anything more, such as JavaDoc links and, for example, only lines 15 through 24:
{@exampleClassSource my.package.AdderDemo#main("my name"):my.package.AdderIxcProcessors#getSourceAdderDemoSnippetWithSelectJavaDocL‌​inksAndIndentedBy(" ")}
Correction: {@exampleClassSource my.package.AdderDemo("my name"):my.package.AdderIxcProcessors#getSourceAdderDemoSnippetWithSelectJavaDocL‌​‌​inksAndIndentedBy(" ")}
 
4:57 PM
Tag names would be more like displaySourceAndOutput, displaySource, displayOutput
 
fge
5:11 PM
I'd prefer an example prefix
But yes, that's that, basically
Not sure what is possible in doclets, probably more (@link can take two arguments for instance)
But such a tool would be great
You do your main etc in your IDE, you test that the output is what you want, you insert {@exampleSourceAndOutput path.to.myClass} and it does the job for you
What's not to like?
 
@fge: I think I understand how it can be done. I got my first Taglet demo working. Its just a matter of parsing the string between {@sourceCode and }. So any arguments are whatever you define them to be.
 
fge
@aliteralmind excellent; and believe me: if you can, make that a project of its own
@aliteralmind it adds great value
@aliteralmind should this project depend on another one
 
You'll set up defaults (like it starts with <PRE>, each line will be indented with three spaces, escaped for HTML, etc.). Any needed overrides, such as JavaDoc linking function names, will have to be specified in a "processor" function, like {@sourceCode my.package.AdderDemo"):my.package.AdderIxcProcessors#linkAdderDemoFuncs()}.
It depends on my overall XBN-Java library.
 
fge
@aliteralmind no -- YOU define the defaults
@aliteralmind if the user wants to change them, then tell them how to do it
 
I'll provide defaults, which you can override if you wish.
 
fge
5:22 PM
@aliteralmind which is how it should be done anyway -- so, good
 
@fge: I'll separate the project out. It's currently a sub-package.
 
fge
@aliteralmind but be sure that I will use it
 
Okay. Thanks for the extra three weeks of work ;) I'll come back when I have something to show you.
 
fge
And contribute should I see the need as well ;)
 
Excellent. :)
 
fge
5:29 PM
@aliteralmind I am really not joking -- this is an excellent tool
 
@fge: Great. Honestly I'm surprised this isn't already out there. I've never looked.
I'm of the Keeping Your Head In The Sand Until You've Finished Rolling Your Own philosophy of programming.
This doclet tag is a huge change, but all the underlying pieces are pretty much done. Good advice, all.
 
fge
@aliteralmind this is a "lazy developer"'s tool; says it all
 
You lazy developers sure require a whole fuck of a lot of work in order to be happy :)
 
fge
@aliteralmind some developers are not reluctant to writing docs, should that doc include code samples; but if they can write code samples which they know work and include that as code directly in the class they implement with a simple doclet...
You basically remove the need to include code samples in docs
And you add proof that it works to boot
What's not to like?
 
I'm glad for the vote of confidence. I honestly thought it would be just another tool that I find invaluable, but no one else uses. I've built a lot of them so far. I'm looking forward to showing you.
@fge: I have to start it all over again, in order to do it the right way, but a lot of pieces are ready and waiting, so it's not so terrible.
 
fge
5:50 PM
@aliteralmind just look at the code examples littered around in the JDK
 
Excellent idea. file:///C:/applications/programming/jdk_7_51/docs/api/java/util/regex/Matcher.ht‌​ml#appendReplacement(java.lang.StringBuffer, java.lang.String)
Oops II: goo.gl/8RsD6D
@fge: Take that specific example. SOME lines from an example code file. Not the whole class (not the license, JavaDoc, public class line, etc.). How would you like to see that in a tag?
Like {@sourceCode my.package.AppendReplacementDemo#lineRange("Pattern p = Pattern.compile("cat");", "System.out.println(sb.toString());")}
Or {@sourceCode my.package.AppendReplacementDemo#my.package.zOutputProcs#getAppendReplacementSni‌​ppet()}
or ???
 
Hello, I need some assistance with my code. Would anyone here be willing to look at my code and tell me what I am doing wrong? It is showing a layer when ran through eclipse, however it does not draw that same layer when it is compiled.
 
fge
@aliteralmind too complicated
@aliteralmind just the package name; this package has a main(); run that main(), insert the result, end of story
s,this package,this class,
@aliteralmind docs.oracle.com/javase/8/docs/api/java/util/concurrent/… <-- here is what I meant
@aliteralmind places to fill in there, but they give a complete code example; however, no one really knows how it runs at all
@aliteralmind however, if they have a full source which they can copy/paste, run, and see that the output is what the javadoc tells them it is... It is all the more easier.
 
6:08 PM
Full code examples seem clear. Just {@sourceCode my.pacakge.DemoClass}.
@fge: But what about partial examples? goo.gl/8RsD6D. How do you want to specify them?
And how do you specify class/function/object names that should be made into JavaDoc links?
 
fge
@aliteralmind that is a different beast... Not sure whether you can actually do that with Javadoc. But if you could that would be generating a class with that code, compile and run it
If you can capture the text and make that text "capturable", then using the compiler API it is possible
 
That's what I'm focusing on. How to customize. JavaDoc links, eliminating the license comment and @author tag.
I don't want to change the code. I just want to tailor it for display.
 
fge
You can paste a java source in there, and I compile that
 
I have license tags in all my example codes, and I need them to be filtered out. I don't want them cluttering up the example in the JavaDoc.
 
fge
Uhwait, I thought the objective was different in this case
Well, as far as I see it
 
6:13 PM
I do not want to change the source code. It's just a matter of filtering it for presentation.
JavaDoc links, eliminating license block, and potentially only showing snippets.
 
fge
And I say you could go further given your first example
Oh, OK
I say you should integrate the result of sample code results in the javadoc
Documentation remains important nevertheless
 
I should say, I already have a pretty powerful filter-er class, which can eliminate the license tag, and add those JavaDoc links as I mentioned.
 
fge
OK, look. I have a very, very featureful class. And in the doc I say that "you can redefine the URI context using {@link URITranslatorConfiguration#setContext(String)}, here are the effects:</p> * {@exampleClass com.github.fge.whatever.examples.Example1}"
I don't seek to eliminate ANY other tag
I want to keep my @see, @since etc
 
My question is only how I should require users of my API to (a) specify it in the {@sourceCode ...} tag, and (b) actually do it, in a "processor function" or whatever that is specifically tailored to that exact example, which is displayed in that exact spot in your JavaDoc.
 
fge
Or @param, @throws, @return
@aliteralmind it is the user which chooses when to use this tag and where
You should not be preoccupied about this at all
You see your tag, you do your job, end of story
Context you don't care
 
6:19 PM
You're saying no JavaDoc links at all, and no filtering at all?
You either display the example code in full or not at all? No snippets?
 
fge
Uhwait
OK, I have to step off for a moment, we'll get back to that later
 
6:47 PM
@fge: Okay. This is my idea. The default is to display an example code's source without any change (no JavaDoc links, no lines removed):
{@sourceCode my.package.AGreatExample}
To filter it in any way (eliminate lines to show only a snippet, JavaDoc link functions, etc.):
{@sourceCodeFiltered my.package.AGreatExample}, or, if numerous filters are needed for a single example-code:
{@sourceCodeFiltered my.package.AGreatExample:SnippetWithLinks}.
This requires a class named my.package.zInsertExampleCodeFilters, which contains a function named getSource_AGreatExample (or getSource_AGreatExample_SnippetWithLinks).
In that function, to display only select lines, you'd specify a single "keep range": `new KeepLinesContainingRange("Pattern.compile(\"cat\");", "println(sb.toString());");
And may some JavaDoc links, too: new JavaDocLinkForFirstInstanceOfFuncName("java.util.regex.Pattern", "compile", "String");
You'd likely put all of these things into a builder InsertExampleFilter_Cfg().keepRange(...).javaDocLinkArray(...).build() which would then be returned by that function, and I'd do black box stuff to make it happen.
 
fge
@aliteralmind didn't read the full text at this moment but here is what I'd like to eliminate and replace with what you do: fge.github.io/json-schema-validator/2.2.x/index.html?com/github/…
Now, sorry but I'm off again :p
 
I'll seriously limit the possibilities to only allowing keep-or-eliminate line ranges and an array of JavaDoc links. Can't think of anything else that's critical.
If they need anything more, they'll have to get into the weeds of my API.
That's it.
@fge That's good to see. I'll look through it.
 
7:36 PM
@fge: I think I've settled on it:
{@file.text examples/doc-files/fstab-good.json}
{@processed.file.text examples/doc-files/fstab-good.json:Good} --> com.github.fge.jsonschema.zFileTextProcessors#getText_fstab_good_json_GOOD()
- Which contains only the ability to specify simple options such as keep- or eliminate-line ranges.
and {@highly.processed.file.text examples/doc-files/fstab-good.json:Good} --> com.github.fge.jsonschema.zFileTextProcessors#getHighlyProcessed_fstab_good_jso‌​n_Good()
- Which allows you to do anything and everything, getting into the weeds of my library.
And for source-code, it's similar: {@source com.github.fge.jsonschema.examples.Example1}, {@processed.source ...} and {@highly.processed.source ...}. The options for @processed are only the ability to filter by line ranges, and change the first occurance of a string to a JavaDoc link.
 
fge
7:53 PM
Uh wait
This is getting off track here
 
8:39 PM
@fge: I'm writing getting started documentation before I start coding anything new. Let me finish it and I'll pass it by you.
 

« first day (1271 days earlier)      last day (3653 days later) »