Old 1st July 2013, 20:08   #1
jmichae3
Junior Member
 
Join Date: Aug 2011
Posts: 19
NSIS 3.0a0 help broken

many of the syntax items (if not all) have 0-height "textboxes" with scrollbars on them so you can't see the syntax. as it turns out, those are XHTML pre tags. somehow, those are getting I think some sort of CSS problem with overflow: or something.
for example CopyFiles, Files
if I could just see the style.css I could maybe debug this.
my default browser is not IE10, but firefox, on windows 7. don't ask me to change browsers.
jmichae3 is offline   Reply With Quote
Old 1st July 2013, 21:19   #2
Anders
Moderator
 
Anders's Avatar
 
Join Date: Jun 2002
Location: ${NSISDIR}
Posts: 5,153
Are you talking about the .chm or plain html files?

http://sourceforge.net/p/nsis/code/6...IS/trunk/Docs/

IntOp $PostCount $PostCount + 1
Anders is offline   Reply With Quote
Old 1st July 2013, 22:00   #3
jmichae3
Junior Member
 
Join Date: Aug 2011
Posts: 19
chm. I did a view source on it to try to debug it as best I could - at least I could see the syntax that way - as long as a person can read XHTML/HTML.
jmichae3 is offline   Reply With Quote
Old 2nd July 2013, 23:51   #4
jmichae3
Junior Member
 
Join Date: Aug 2011
Posts: 19
what's happening is that if the help window is too small, the scroll bars show on the pre tags, and the vertical scroll bar ends up with too little space, so it doesn't show.

it is possible this is something you can't fix. don't know. pre tags on my web pages can cause scroll bars on the browser, however, it is unknown to me if the html help application is capable of displaying scroll bars or not at the bottom.

it's also possible the best and only solution is to simply resize the window?
jmichae3 is offline   Reply With Quote
Old 3rd July 2013, 11:49   #5
Yathosho
Forum King
 
Yathosho's Avatar
 
Join Date: Jan 2002
Location: AT-DE
Posts: 3,363
if you're talking about what you see in the attached screenshot, i'm getting this for the old 2.46 docs as well (could be my viewer though!)

Quote:
Originally Posted by jmichae3 View Post
it's also possible the best and only solution is to simply resize the window?
this hardly deserves being called a "solution"

on a side-note, i never understood why open source software would support a proprietary, though reverse-engineered format like .chm. the functionality of the windows help viewer can easily be replicated in html (solutions are plenty!) i hate installing a chm-viewer whenever i'm not on windows. since nsis can be compiled on non-windows platforms, a non-windows manual makes sense! a non-compiled html documentation can be viewed offline on every platform without the need of extra software.

also, i'd like to mention that the official online documentation is not up-to-date. updating it to 3.0a0 is probably a better choice than using a manual that lists commands that aren't used by any stable version or the alpha (e.g. TargetMinimalOS.)
Attached Thumbnails
Click image for larger version

Name:	Screen shot 2013-07-03 at 13.40.06.png
Views:	170
Size:	151.6 KB
ID:	50670  
Yathosho is offline   Reply With Quote
Old 4th July 2013, 14:04   #6
Anders
Moderator
 
Anders's Avatar
 
Join Date: Jun 2002
Location: ${NSISDIR}
Posts: 5,153
Quote:
Originally Posted by Yathosho View Post
on a side-note, i never understood why open source software would support a proprietary, though reverse-engineered format like .chm. the functionality of the windows help viewer can easily be replicated in html (solutions are plenty!) i hate installing a chm-viewer whenever i'm not on windows. since nsis can be compiled on non-windows platforms, a non-windows manual makes sense! a non-compiled html documentation can be viewed offline on every platform without the need of extra software.
When building you can generate chm and html docs at the same time if you want (Multiple pages or single page html). The docs are in the format used by the halibut generator and it could probably generate pdf and rtf if you really wanted to as well...

IntOp $PostCount $PostCount + 1
Anders is offline   Reply With Quote
Old 4th July 2013, 22:29   #7
Yathosho
Forum King
 
Yathosho's Avatar
 
Join Date: Jan 2002
Location: AT-DE
Posts: 3,363
i'm well aware of the halibut generator, but still .chm is a rather closed format. a personal favourite of mine would be markdown, though even more than for a manual it's an ideal format for 3rd party addon developers. writing a proper documentation is often the part where developers get lazy and having to write two versions (distributed and wiki) doesn't help it. markdown is very readable in plain-text and there are many ways to render them in the browser to html, or use it for cms platforms and even wikis.

anyway, there are currently four versions of the nsis documentation: distributed chm, the html scripting reference on sf.net, the wiki and also github-hosted markdown. there are plenty of choices. unfortunately, not all are on the same level, which is something that should be looked into in the future (i've been testing out several things already, more to come!)
Yathosho is offline   Reply With Quote
Old 5th July 2013, 22:57   #8
jmichae3
Junior Member
 
Join Date: Aug 2011
Posts: 19
I see
jmichae3 is offline   Reply With Quote
Old 6th July 2013, 01:15   #9
Anders
Moderator
 
Anders's Avatar
 
Join Date: Jun 2002
Location: ${NSISDIR}
Posts: 5,153
Maybe we need to add 0.5em top&bottom padding or something like that...

IntOp $PostCount $PostCount + 1
Anders is offline   Reply With Quote
Old 14th July 2013, 20:31   #10
kichik
M.I.A.
[NSIS Dev, Mod]
 
kichik's Avatar
 
Join Date: Oct 2001
Location: Israel
Posts: 11,343
Should be fixed with 3.0a1.

NSIS FAQ | NSIS Home Page | Donate $
"I hear and I forget. I see and I remember. I do and I understand." -- Confucius
kichik is offline   Reply With Quote
Old 29th July 2013, 08:27   #11
jmichae3
Junior Member
 
Join Date: Aug 2011
Posts: 19
that fixed it! thanks!
jmichae3 is offline   Reply With Quote
Reply
Go Back   Winamp & Shoutcast Forums > Developer Center > NSIS Discussion

Thread Tools Search this Thread
Search this Thread:

Advanced Search
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump