11 Replies Latest reply on Jun 23, 2005 3:31 PM by Adrian Brock

    Documentation Error - Cant find

    Hugh Gleaves Newbie

      On page 9 of the "Getting started with JBoss 4" Version 4 document is a reference (near bottom of page) to "conf/props" directory.

      I am trying to follow this documentation as I familiarize myself with the product.

      No such dir can be found, and if it is in some obscure directory then I dont know what that is or where.

      I suspect the documentation needs correcting.

      With regard to documentation, what is the best way for me to fire coments and/or suggestions about documentation back to the JBoss staff?

      I have noted several places where the doc could be improved, this is probably espcially useful since I know little about JBoss or Java or Beans etc, but have a solid background in softweare dev, servers, databases and compilers, so my comments may improve accuracy and clarity.

      Rgds
      Hugh

        • 1. Re: Documentation Error - Cant find
          Adrian Brock Master

          In this cunningly entitled forum. :-)

          But then if you couldn't even find this forum (or READ THIS FIRST in the jmx forum),
          I'm not surprised you can't find the conf/ folder.

          • 2. Re: Documentation Error - Cant find
            Norman Richards Master

            It's possible he's just using the wrong version of JBoss. The props directory didn't exist until 4.0.2.

            • 3. Re: Documentation Error - Cant find
              Hugh Gleaves Newbie

              I find your response arrogant and bad business sense.

              You dont know anything about me, what influence I have or how I might be considering paying for services from your company; so why choose to be so flippant I just don't know.

              I only hope that your attitude is not representative of the corporation itself.

              I am compelled to contrast your reply to my posting with this sentence found here:

              http://www.jboss.com/company/index


              professional support services expected of a traditional software vendor


              You certainly need to ask your manager's opinion to see if your reply is at odds with this company goal.

              I'm neither impressed nor intimidated by sarcasm, you have no idea what stresses and pressure I may be under whilst I am trying to follow your documentation, study the product, execute test etc, and how this might lead me to miss something from time to time.

              You have said nothing about the discrepancy between the documentation and the directory structure that I have here, so how about less pretension and some goold old professionalism?

              Rgds
              Hugh




              • 4. Re: Documentation Error - Cant find
                Hugh Gleaves Newbie

                For any professional individuals that may be following this thread, my expanded dir pathname is:

                C:\WebPlatform\Downloads\JBoss\4.0.2RC1\jboss-4.0.2RC1\server\default\conf

                and in that dir are two sub dirs

                jboss.web
                xmdesc

                I cannot see any dir named "props" so either I am looking in thr wrong place or the documentation has a typo.

                Many thanks
                Hugh

                • 5. Re: Documentation Error - Cant find
                  Hugh Gleaves Newbie

                  OK I scanned my dir tree, only these dirs contain a file named "jmx-console-users.properties"

                  C:\WebPlatform\Downloads\JBoss\4.0.2RC1\jboss-4.0.2RC1\server\all\deploy\jmx-console.war\WEB-INF\classes

                  and

                  C:\WebPlatform\Downloads\JBoss\4.0.2RC1\jboss-4.0.2RC1\server\default\deploy\jmx-console.war\WEB-INF\classes

                  also from what I can see, there is no directory anywhere in the unzipped tree, called "props".

                  Rgds
                  Hugh

                  • 6. Re: Documentation Error - Cant find
                    Adrian Brock Master

                    Congratulations, you just failed the sense of humour test and have one less person
                    to give you *FREE* help.

                    Next time, I'll leave you stewing in the wrong forum with no responses.

                    On the rest of your verbage, I've heard it all before.
                    This is jboss.org (open source free help for non time wasters)
                    not jboss.com (professional open source for people that pay).

                    • 7. Re: Documentation Error - Cant find
                      Norman Richards Master

                       

                      "Solver" wrote:

                      C:\WebPlatform\Downloads\JBoss\4.0.2RC1\jboss-4.0.2RC1\server\all\deploy\jmx-console.war\WEB-INF\classes


                      4.0.2RC1 means release candidate. It means it's not the real 4.0.2 and that things might change before the final release. In this case, it did. Please download JBoss 4.0.2 and try again.



                      • 8. Re: Documentation Error - Cant find
                        Adrian Brock Master

                         

                        "Solver" wrote:
                        For any professional individuals that may be following this thread, my expanded dir pathname is:

                        C:\WebPlatform\Downloads\JBoss\4.0.2RC1\jboss-4.0.2RC1\server\default\conf


                        and for those others who unprofessionally expect questions to be answered
                        without doing any research themselves:
                        http://wiki.jboss.org/wiki/Wiki.jsp?page=JBossDirectoryStructure

                        • 9. Re: Documentation Error - Cant find
                          Hugh Gleaves Newbie

                          Yes Adrian and you work for JBoss Inc, or so your signature claims; so like it or not you are representing the corporation and convey an impression of their overal quality of service and approach to handling customer support.

                          If that was all you had to offer, then better to have said nothing, surely?

                          Don't go on about "free", please? I could claim to be giving you free feedback on bugs and documentation errors, could I not?

                          I have been using the software for a couple of hours and have sent you one acknowledged bug and one documentation error, this can only help to improve the product and hence the company of which you are an employee, so it is I who has helped you I think.

                          Now regarding the doc, I think it is clear that it is in error and this should now be corrected with as much vigor as is expended on bug fixing.

                          Perhaps it is only the Win32 build that does this but whatever, here is an opportunity to improve the product yet further.

                          Rgds

                          Hugh


                          PS: I have no problem with humor, but your posting was not humorous and uses no smileys to convey that, it also ignored the essence of my post and focused upon me, the poster rather than the substance of what was originally posted.

                          • 10. Re: Documentation Error - Cant find
                            Hugh Gleaves Newbie

                            Norman

                            Thanks for clarifying, my mistake, your assistance is much appreciated.

                            Hugh

                            • 11. Re: Documentation Error - Cant find
                              Adrian Brock Master

                               

                              "Solver" wrote:

                              Don't go on about "free", please? I could claim to be giving you free feedback on bugs and documentation errors, could I not?


                              It was only because you reported the jmx bug that I didn't ignore you, like everybody
                              else would have done with the quality of questions.

                              One thing about free forums (there I used the word again :-) is that nobody likes a time
                              sink that obviously isn't doing any research for themselves. You just get ignored (at best).

                              It isn't my fault that my supposed joke was taken the wrong way and answered with
                              a tirade of abuse.