Does anyone know if you can pass a build number reference into compiled help as part of the command line API?
Thanks!
Build Reference Number
Re: Build Reference Number
Not directly as far as I know, but I do manage to do this using MadBuild and a bit of a bodge.
Firstly, use variable for your build reference number. Then you can set it to the value you require in your target file. If that's all you need, and are happy to edit the target file and do a manual build, you're done.
But, if, as I think is more likely, you want to hook this up to an auto-build as part of the software build, you will need an extra step. Before calling MadBuild, you will need to do a substitution to replace the variable value in the target file with the build version. I just make sure my variable value in the target file is something I can find easily using search and replace (I use [[BUILDVERSION]]) but you could use something like FAR HTML in batch mode which would give you a slightly more flexible search. We don't have FAR HTML (yet) on our build servers, or I would have done that by now.
I think there are two sorts of variables, those that are target-specific (like, in my case, the product name, the document name etc) and those that are build-specific (like the build version, the document version and the date). The first sort of variable is fine to set on a per-target basis. the others need to be set on a per-build basis. I've already raised a feature request asking for the ability to specify values for variables when you call MadBuild. If this is what you need too, please raise a feature request too. The more of us that ask for something, the more likely we are to get it.
Firstly, use variable for your build reference number. Then you can set it to the value you require in your target file. If that's all you need, and are happy to edit the target file and do a manual build, you're done.
But, if, as I think is more likely, you want to hook this up to an auto-build as part of the software build, you will need an extra step. Before calling MadBuild, you will need to do a substitution to replace the variable value in the target file with the build version. I just make sure my variable value in the target file is something I can find easily using search and replace (I use [[BUILDVERSION]]) but you could use something like FAR HTML in batch mode which would give you a slightly more flexible search. We don't have FAR HTML (yet) on our build servers, or I would have done that by now.
I think there are two sorts of variables, those that are target-specific (like, in my case, the product name, the document name etc) and those that are build-specific (like the build version, the document version and the date). The first sort of variable is fine to set on a per-target basis. the others need to be set on a per-build basis. I've already raised a feature request asking for the ability to specify values for variables when you call MadBuild. If this is what you need too, please raise a feature request too. The more of us that ask for something, the more likely we are to get it.
Marjorie
My goal in life is to be as good a person as my dogs already think I am.
My goal in life is to be as good a person as my dogs already think I am.