|
Title: Re: [amibroker] Re: Double braces
I hate to prolong this thread but this must be said.
The effort to improve documentation grows exponentially when you exceed basic effectiveness. Improving from "B" grade Help to an "A" grade is easy (imo, this has been done), but improving from an "A" to an "A++" is a lot more serious work.
AmiBroker sells its product on the merits of performance, some other products sell their products on the merit of their documentation. Which do you prefer?
Personally I would much prefer to have all this energy go into product development.
Best regards,
herman
Monday, September 1, 2008, 7:44:10 AM, you wrote:
> Paul,
> That's fair enough. Now I know that using specific google searches for
> www.amibroker.com is the easiest way to find what I'm after, and
> that's how the land lies and is likely to continue to lie, no problem.
> However, owning a number of other commerical pieces of software, none
> of which I have to use google for to find the info I'm after, forgive
> me if at first it's not obvious. Secondly, the master himself (TJ) has
> admitted that, I quote, "documentation could and should be improved in
> many areas".
> So you giving the teacher an apple doesn't really change anything.
> --- In amibroker@xxxxxxxxxxxxxxx, "Paul Ho" <paul.tsho@xxx> wrote:
>> TJ
>> Do you ever think if you could put every possible term that
>> people can ever dream of in the user manual, there will be no
>> complaints about no being able to find things. I believe you will get
>> no less complaints and questions. My judgement on
>> the help/user manuals is pretty much like what Herman has said this
>> post: http://finance.groups.yahoo.com/group/amibroker/message/129052.
>> I, and many others have mentioned at least 5 times in the last 5 days
>> about using google. Let see if we put in "Title = "{{NAME}}
>> site:www.amibroker.com" and see what we find, we have lots of hits,
>> not of it useful. But I find this little gem you wrote in March 2006
>> here http://www.amibroker.com/kb/2006/03/04/how-to-change-the-title-
>> line-in-my-custom-indicator/ . It is quite clear that those who wants
>> to help themselves are able to find things, even if they had to ask
>> for help on their first time. There are tons of search tips from
>> google on how to get better hits, if only one wants to study and
>> apply them.
>> There are always those who will keep complaining, and you cant really
>> help them, because they wont help themselves. I believe what you've
>> got as a set up that is quite adequate, if anything, group together
>> pages that can be search easily, e.g. user guide & readme, dev log in
>> one search domain, afl library in another domain etc, and encourage
>> people to google to their hearts contend.
>> --- In amibroker@xxxxxxxxxxxxxxx, "Tomasz Janeczko" <groups@>
>> wrote:
>> >
>> > Hello,
>> >
>> > ReleaseNotes.html that is present in AmiBroker directory.
>> >
>> > > It's a serious question... a plea really... is there a way of
>> > > improving access to this kind of info...?
>> >
>> > That's a bit difficult. In the past release notes were part of the
>> User's Guide.
>> > But since release notes are huge now, and would bump the size
>> > of printed guide by 200+ (?) pages or so, they are not part of
>> user's guide
>> > anymore, but available as separate document.
>> >
>> > As Herman noted placing shortcut on the desktop to release notes
>> > doc and read me is good idea because, because even if things can
>> not be found
>> > in the official guide they still are covered in the change log.
>> >
>> > It is a bit difficult to have one document (guide) that fits all.
>> > If it is too detailed, then it can be seen as "too advanced",
>> > if is is easy to follow/read then it would miss the details.
>> > Maybe different guides at different levels of complexity, but then
>> > searching multiple guides is an issue.
>> >
>> > I realize, more than some may think that I am, that documentation
>> > could and should be improved in many areas. And I am working with
>> each
>> > release to make it better. It does not happen in a day because it is
>> > really a task to update 900+ pages of the guide alone.
>> > I belive that Howard's new book will fit perfectly as introduction
>> to AmiBroker
>> > and "first level/absolute beginner" help. I will need to take care
>> about the rest.
>> >
>> > Best regards,
>> > Tomasz Janeczko
>> > amibroker.com
>> > ----- Original Message -----
>> > From: "sidhartha70" <sidhartha70@>
>> > To: <amibroker@xxxxxxxxxxxxxxx>
>> > Sent: Monday, September 01, 2008 11:30 AM
>> > Subject: [amibroker] Re: Double braces
>> >
>> >
>> > > TJ,
>> > >
>> > > 'release notes.html' that is present under the AmiBroker
>> directory...?
>> > > The directory is under 'Files' on this user group or somewhere
>> else...?
>> > >
>> > > Sorry to be a complete dimwit... but this is sort of what I mean
>> by
>> > > accessibility. I have spent a good amount of time playing around
>> with
>> > > double braces in the past in order to get chart titles to display
>> > > exactly as I wanted. I had little success. I looked around for
>> > > information on how the double braces work, and couldn't find
>> anything
>> > > at all. I'm fairly sure this is a familar story.
>> > >
>> > > It's a serious question... a plea really... is there a way of
>> > > improving access to this kind of info...?
>> > >
>> > > Thanks
>> > >
>> > > --- In amibroker@xxxxxxxxxxxxxxx, "Tomasz Janeczko" <groups@>
>> wrote:
>> > >>
>> > >> Hello,
>> > >>
>> > >> {{OHLCX}} was added in 4.72, others were added earier (4.60.2).
>> > >> All informations like that are always present in the CHANGE LOG
>> > >> that you will find in read me's that accompany betas.
>> > >> ReadMe's are created from implementation notes that I write when
>> I
>> > > actually
>> > >> implement given function so there is always a mention in the docs
>> > > about each bit changed.
>> > >> Once beta becomes official, all read me notes are added
>> to "release
>> > > notes.html" document
>> > >> that is present in the AmiBroker directory.
>> > >>
>> > >> Excerpt from change log (4.60.2):
>> > >>
>> > >> Title variable templates: making Title statements easy.
>> > >> Now you can embed special tokens in Title variable
>> > >> that are replaced by appropriate values at run-time.
>> > >> if you use {{VALUES}} inside Title string
>> > >> it will be replaced by automatic-values generated by Plot
>> function
>> > > calls.
>> > >> if you use {{NAME}} it will be replaced by ticker symbol.
>> > >> if you use {{DATE}} it will be replaced by selected date
>> > >> if you use {{INTERVAL}} it will be replaced by name of the
>> interval
>> > >> Example:
>> > >> Title = "{{NAME}} - {{INTERVAL}} {{DATE}} - MyChart :
>> {{VALUES}}";
>> > >>
>> > >>
>> > >> Some additions and small improvements like support for double
>> braces
>> > > in title string
>> > >> were added for my own use, so they appear only in change log and
>> are
>> > > not "advertised" elsewhere.
>> > >> You need to keep in mind the fact that I am also using this
>> software
>> > > for my own,
>> > >> and sometimes add things for my own purposes.
>> > >> As when you buy a car you don't get service manual, but only
>> user's
>> > > manual. With AB, CHANGE LOG
>> > >> is "low-level" service reference for geeks ;-).
>> > >>
>> > >> Best regards,
>> > >> Tomasz Janeczko
>> > >> amibroker.com
>> > >> ----- Original Message -----
>> > >> From: "Graham" <kavemanperth@>
>> > >> To: <amibroker@xxxxxxxxxxxxxxx>
>> > >> Sent: Monday, September 01, 2008 10:08 AM
>> > >> Subject: Re: [amibroker] Re: Double braces
>> > >>
>> > >>
>> > >> > good question - answer No idea.
>> > >> > Just worked from memory when they were introduced back in the
>> > > stone age :)
>> > >> >
>> > >> > --
>> > >> > Cheers
>> > >> > Graham Kav
>> > >> > AFL Writing Service
>> > >> > http://www.aflwriting.com
>> > >> >
>> > >> >
>> > >> > 2008/9/1 sidhartha70 <sidhartha70@>:
>> > >> >> Graham,
>> > >> >>
>> > >> >> Can I ask, not being an AFL expert, where you would go to find
>> > >> >> information such as this...? I have often wondered about the
>> double
>> > >> >> braces myself, but never known where to go to find the
>> requisite
>> > >> >> information.
>> > >> >>
>> > >> >> --- In amibroker@xxxxxxxxxxxxxxx, Graham <kavemanperth@>
>> wrote:
>> > >> >>>
>> > >> >>> The only other one is {{OHLCX}} which shows the OHLC and ROC
>> values
>> > >> >> in title
>> > >> >>> The {{}} don't always pass correctly except to title line
>> > >> >>>
>> > >> >>>
>> > >> >>>
>> > >> >>> 2008/9/1 tipequity <l3456@>:
>> > >> >>> > TJ uses the following line of code in many functions that
>> come
>> > >> >> with AB.
>> > >> >>> >
>> > >> >>> > _N(Title = StrFormat("{{NAME}} - {{INTERVAL}} {{DATE}} Open
>> > > %g, Hi %g,
>> > >> >>> > Lo %g, Close %g (%.1f%%) Vol " +WriteVal( V, 1.0 ) +"
>> > > {{VALUES}}", O,
>> > >> >>> > H, L, C, SelectedValue( ROC( C, 1 )) ));
>> > >> >>> >
>> > >> >>> > Are there any other information that can be passed to chart
>> > > title thru
>> > >> >>> > {{}} beside the three listed above? TIA
>> > >> >>> >
>> > >> >
>> > >> > ------------------------------------
>> > >> >
>> > >> > Please note that this group is for discussion between users
>> only.
>> > >> >
>> > >> > To get support from AmiBroker please send an e-mail directly
>> to
>> > >> > SUPPORT {at} amibroker.com
>> > >> >
>> > >> > For NEW RELEASE ANNOUNCEMENTS and other news always check
>> DEVLOG:
>> > >> > http://www.amibroker.com/devlog/
>> > >> >
>> > >> > For other support material please check also:
>> > >> > http://www.amibroker.com/support.html
>> > >> > Yahoo! Groups Links
>> > >> >
>> > >> >
>> > >> >
>> > >>
>> > >
>> > >
>> > >
>> > > ------------------------------------
>> > >
>> > > Please note that this group is for discussion between users only.
>> > >
>> > > To get support from AmiBroker please send an e-mail directly to
>> > > SUPPORT {at} amibroker.com
>> > >
>> > > For NEW RELEASE ANNOUNCEMENTS and other news always check DEVLOG:
>> > > http://www.amibroker.com/devlog/
>> > >
>> > > For other support material please check also:
>> > > http://www.amibroker.com/support.html
>> > > Yahoo! Groups Links
>> > >
>> > >
>> > >
>> >
> ------------------------------------
> Please note that this group is for discussion between users only.
> To get support from AmiBroker please send an e-mail directly to
> SUPPORT {at} amibroker.com
> For NEW RELEASE ANNOUNCEMENTS and other news always check DEVLOG:
> http://www.amibroker.com/devlog/
> For other support material please check also:
> http://www.amibroker.com/support.html
> Yahoo! Groups Links
> <*> To visit your group on the web, go to:
> http://groups.yahoo.com/group/amibroker/
> <*> Your email settings:
> Individual Email | Traditional
> <*> To change settings online go to:
> http://groups.yahoo.com/group/amibroker/join
> (Yahoo! ID required)
> <*> To change settings via email:
> mailto:amibroker-digest@xxxxxxxxxxxxxxx
> mailto:amibroker-fullfeatured@xxxxxxxxxxxxxxx
> <*> To unsubscribe from this group, send an email to:
> amibroker-unsubscribe@xxxxxxxxxxxxxxx
> <*> Your use of Yahoo! Groups is subject to:
> http://docs.yahoo.com/info/terms/
__._,_.___
Please note that this group is for discussion between users only.
To get support from AmiBroker please send an e-mail directly to
SUPPORT {at} amibroker.com
For NEW RELEASE ANNOUNCEMENTS and other news always check DEVLOG:
http://www.amibroker.com/devlog/
For other support material please check also:
http://www.amibroker.com/support.html
![]()
__,_._,___
|