World: r4wp
[Ann-Reply] Reply to Announce group
older newer | first last |
Robert 1-Jun-2013 [2094] | checking. Which docs fail? We moved some around. |
Pekr 1-Jun-2013 [2095x3] | gui docs ... |
all of them ... | |
maybe your svn server is down then ... | |
Robert 1-Jun-2013 [2098] | no, changed path. fixed. |
GrahamC 2-Jun-2013 [2099] | Is there a link for the mac saphir build? Or was that just to say it builds? |
Henrik 2-Jun-2013 [2100] | It seems R3/Saphir for OSX doesn't run on 10.6.8. Can anyone confirm? |
Geomol 2-Jun-2013 [2101x2] | If it's the r3-osx file from: http://development.saphirion.com/experimental/ , then I get the following on OS X 10.7.5: 504 ~/r3$ ./r3-osx Illegal instruction: 4 |
The file is dated 2-Jun-2013 21:11 r3-osx 02-Jun-2013 21:11 513K | |
Robert 2-Jun-2013 [2103] | yes, it's the correct file |
Henrik 2-Jun-2013 [2104] | Works fine under 10.8. |
Geomol 4-Jun-2013 [2105] | Robert, if it's extra work to make it work with earlier versions of OS X, then maybe you shouldn't use too much time on it. We can just upgrade to latest OS X, which at least I will eventually do at some point. Maybe some hardware can't be updated, I don't know. |
Oldes 4-Jun-2013 [2106x5] | Reagarding Saphirion's documentation - maybe it's silly question, but could you try to change extension from .mdp to .md and see what's the difference on GitHub? I'm sure that it would look a little bit better directly in the browser as at least syntex for headers is almost similar in MarkDown as in MakeDocPro. |
Code block syntax is also same - 4 space or 1 tab indentation. | |
Hmmm... the syntax is a little bit different, but it's not too hard to change it to md. Compare: https://github.com/Oldes/documentation/blob/master/argpass.mdwith https://github.com/saphirion/documentation/blob/master/argpass.mdp | |
Even without header's modification and just changed extension produces more readable document: https://github.com/Oldes/documentation/blob/master/arity.mdversus https://github.com/saphirion/documentation/blob/master/arity.mdp | |
I believe it's easier to modify MDP to be more compatible with rest of the world than waiting for world to adopt MDP. But it's your choise of course. | |
AdrianS 4-Jun-2013 [2111] | Ladislav, is the method you outlined for defining variadic functions is there a way not to have the variadic function not change the arity of any functions following the variadic function? i.e. with the definition of 'sumn, as you have it, if you have the following in a script: print sumn 1 2 print "hello" The "hello" doesn't print. I guess this is because when Rebol is 'do-ing the script, the 'print is returned by the variadic function and the 'do dialect somehow doesn't re-interpret that word with its following argument, but sees it as a no-argument 'print. If, on the other hand, you have: print sumn 1 2 do print "hello" ;or if you have something like "foo" instead of the 'do hello will be printed out as intended Could you describe what is happening here since I'm not exactly sure I understand how Rebol is handling things? Among other things, how is it OK to invoke arg-adder without providing the one arg it expects when you have "return/redo :arg-adder? |
Andreas 4-Jun-2013 [2112] | (Probably the best group for this discussion is !REBOL3.) |
AdrianS 4-Jun-2013 [2113] | I don't know if I should spam the message into a third group, but it's fine with me to move discussion there. |
Henrik 5-Jun-2013 [2114] | Oldes, I have a dream about an MDP2 that will start with Markdown compatibility. Actually, no, I have a spec document, but am not sure I should publish it yet. |
MaxV 5-Jun-2013 [2115] | Where are Saphirion sources? |
Pekr 5-Jun-2013 [2116] | Will be released later .... |
GrahamC 5-Jun-2013 [2117] | Henrik, correct me if I'm wrong but isn't markdown just a text formatting system as opposed to a document formatting system like make-doc ? |
Henrik 5-Jun-2013 [2118] | Yes, but it seems to make sense to base body text on this and build the rest around it. MDP has a particular way to format body text, but we've found that it's hard to extend. I would like an MDP2 that much better is capable of outputting right down from a single paragraph of markdown to a full multi-page document. |
GrahamC 5-Jun-2013 [2119x2] | well, to me it makes sense not to reinvent the world and just use an existing markup like asciidoc which is intended for documents |
No one is going to convince the world to learn another markup language like mdp2 | |
Henrik 5-Jun-2013 [2121] | Another point of MDP2 is to retain the single-script ease of use that MDP has, as well as being REBOL based. |
GrahamC 5-Jun-2013 [2122] | I think that you can do that with asciidoc too .. using Chris' emitter and parser |
Oldes 5-Jun-2013 [2123] | It would be really enough to have MDP accept MD's style of headings. It's just silly from the outside view to use extension .mdp instead of already supported .md. I know that mdp is better and more capable than md, but I don't think it's easy to change Github to use mdp. I'm quite lucky that my Rebol colorizer (even buggy a little bit) found it's way there, which was not straight at all. |
Henrik 5-Jun-2013 [2124] | It would be really enough to have MDP accept MD's style of headings. - are you referring to MakeDoc or MarkDown? :-) |
GrahamC 5-Jun-2013 [2125] | He's saying that using %.md for your existing %.mdp documents would be enough to use the existing markdown colouriser |
Oldes 5-Jun-2013 [2126] | Unfortunately not enough to change extension. MDP is using === and --- for headers, where MarkDown is using ### http://daringfireball.net/projects/markdown/syntax |
GrahamC 5-Jun-2013 [2127x2] | but at least it's better than nothing?? |
Although in the case of the broken R3 colouriser ... nothing is probably better :( | |
Gregg 6-Jun-2013 [2129] | As much as I love makedoc, and as many docs as I have in that format, a more widely adopted standard that is close in syntax and features seems like the best option as a standard. |
GrahamC 6-Jun-2013 [2130] | I am advocating also that we be pragmatic rebolers |
Pekr 6-Jun-2013 [2131x2] | ah, noticed Red's main git page uses some .md file. Thought that Github accepted our MD :-) |
Is their md any less performant than mdp? As for me, +1 to accept some widely accepted format. Well, does anyone apart Git use .md? | |
AdrianS 6-Jun-2013 [2133] | Petr, it's used quite a bit these days. Just look around. I vote to go with a standard. Didn't we already have this discussion? |
Arnold 6-Jun-2013 [2134x2] | yes lets go on using VHS, not betamax or v2000. It is a bit similar. If mdp2 can be more flexible than MD and you can show it is as easy as MD and even do more with it, who needs to convince the world? The whole world is far from using MD now. There is a whole lot of undiscovered country left. |
And if you can have mdp process MD doc's with very little adaptation (adding a kind of marker at the beginning) you can easily take over MD. | |
Henrik 6-Jun-2013 [2136] | Arnold, yes, there are many competent document systems out there, but there hasn't been anyone that could be so easily plugged in and used as MakeDoc and MakeDocPro. I just want to move beyond their current limitations, so Saphirion can deliver professional, high-quality manuals to the customers. |
Pekr 6-Jun-2013 [2137x2] | AdrianS: I am not against that. Still I have my question of the feature comparison of MD vs MDP unanswered ... |
So basically - is MDP so much better, that we can't switch to MD instead? | |
Henrik 6-Jun-2013 [2139] | Pekr, I'll try to get a response from Robert, as he decides which way to go. |
Ted 6-Jun-2013 [2140] | http://www.codinghorror.com/blog/2012/10/the-future-of-markdown.html |
Arnold 6-Jun-2013 [2141] | I found MarkDown a good thought, like mdp, and ther obviously has been put some clever thinkwork into it, but six hashes for a h6 tag? And the alternative underline with "====" and or "----" does not convince me what happens if you do not match the length of the header? It compensates? so why not 3 or four like in mdp? |
Pekr 6-Jun-2013 [2142] | if others might maky their stuff and claim it beind de-facto standard, we can as well ... not sure if markdown is more popular than what github is using for their .md, but we should either adhere, or make converters and go our own way, or even better - introduce some clever layer, which will allow to recognise their format and render it properly, while allowing .mdp to be more powerful |
Arnold 6-Jun-2013 [2143] | what I said, in other words ;) |
older newer | first last |