Comments on: Is creating a unit a “user” function? http://www.texdev.net/2009/02/08/is-creating-a-unit-a-user-function/ Coding in the TeX world Tue, 07 Feb 2012 20:07:12 +0000 hourly 1 By: Joseph Wright http://www.texdev.net/2009/02/08/is-creating-a-unit-a-user-function/#comment-207 Joseph Wright Sat, 07 Mar 2009 14:07:35 +0000 http://www.texdev.net/?p=168#comment-207 Hello Stefan, From various things I've been doing (LaTeX3 work, name space questions, looking at other packages, answering questions, etc.) I'm pretty convinced that this type of "set up" macro should use design-like naming (upper- and lower-case mixed names). Hence thinking about \DeclareUnit. The current working copy uses: - \DeclareSIPrefix - \DeclareSIPower - \DeclareSIQualifier - \DeclareSIUnit Most users will probably never need to use these macros, and I think that the names should now be both memorable and very unlikely to clash with anything. Joseph Hello Stefan,

From various things I’ve been doing (LaTeX3 work, name space questions, looking at other packages, answering questions, etc.) I’m pretty convinced that this type of “set up” macro should use design-like naming (upper- and lower-case mixed names). Hence thinking about \DeclareUnit. The current working copy uses:

- \DeclareSIPrefix
- \DeclareSIPower
- \DeclareSIQualifier
- \DeclareSIUnit

Most users will probably never need to use these macros, and I think that the names should now be both memorable and very unlikely to clash with anything.

Joseph

]]> By: Stefan Pinnow http://www.texdev.net/2009/02/08/is-creating-a-unit-a-user-function/#comment-203 Stefan Pinnow Sat, 07 Mar 2009 10:47:39 +0000 http://www.texdev.net/?p=168#comment-203 Hi Joseph, what about the \addunit command from the siunits package? Best regards, Stefan Hi Joseph,
what about the \addunit command from the siunits package?

Best regards,
Stefan

]]> By: Joseph Wright http://www.texdev.net/2009/02/08/is-creating-a-unit-a-user-function/#comment-104 Joseph Wright Wed, 11 Feb 2009 19:22:17 +0000 http://www.texdev.net/?p=168#comment-104 The plan for v2 is that by default I'll only define stuff inside \SI and \si (although there will be an option to control this). So I'm also in favour of \Declare ... I'm probably not going to go for \DeclareUnit as I suspect it is still too general (there are other things which are "units"). The plan for v2 is that by default I’ll only define stuff inside \SI and \si (although there will be an option to control this). So I’m also in favour of \Declare … I’m probably not going to go for \DeclareUnit as I suspect it is still too general (there are other things which are “units”).

]]> By: phi http://www.texdev.net/2009/02/08/is-creating-a-unit-a-user-function/#comment-103 phi Wed, 11 Feb 2009 17:57:55 +0000 http://www.texdev.net/?p=168#comment-103 If the unit macros are undefined outside of \SI or \si, then name clashes are nearly impossible and one \DeclareUnit macro would be sufficient. On the other hand, it would not be too difficult to provide the other combinations. My suggestion in this case is \CreateUnit, \OverwriteUnit, \DeclareUnit and \ProvideUnit. I don't like names like \newcommand—they are hard to read and don't follow the usual verb–object pattern. If the unit macros are undefined outside of \SI or \si, then name clashes are nearly impossible and one \DeclareUnit macro would be sufficient. On the other hand, it would not be too difficult to provide the other combinations. My suggestion in this case is \CreateUnit, \OverwriteUnit, \DeclareUnit and \ProvideUnit. I don’t like names like \newcommand—they are hard to read and don’t follow the usual verb–object pattern.

]]> By: Joseph Wright http://www.texdev.net/2009/02/08/is-creating-a-unit-a-user-function/#comment-99 Joseph Wright Mon, 09 Feb 2009 08:36:06 +0000 http://www.texdev.net/?p=168#comment-99 This was broadly my thinking, to be honest. I'm not so struck on \DeclareSIunit because I think it doesn't really follow the usual "rules" for desgin-type macro names (should be \DeclareSIUnit, which I find hard to read). This was broadly my thinking, to be honest. I’m not so struck on \DeclareSIunit because I think it doesn’t really follow the usual “rules” for desgin-type macro names (should be \DeclareSIUnit, which I find hard to read).

]]> By: Will Robertson http://www.texdev.net/2009/02/08/is-creating-a-unit-a-user-function/#comment-98 Will Robertson Mon, 09 Feb 2009 04:33:35 +0000 http://www.texdev.net/?p=168#comment-98 How important do you judge it to be that users will really need the distinction between new/renew/provide ? For something this specialised, I'd be inclined to stick to only using \Declare -- similar to, e.g., amsmath's \DeclareMathOperator. I'd steer clear of \create, just because it's different. Another possible option: \DeclareSIunit ? How important do you judge it to be that users will really need the distinction between new/renew/provide ? For something this specialised, I’d be inclined to stick to only using \Declare — similar to, e.g., amsmath’s \DeclareMathOperator. I’d steer clear of \create, just because it’s different.

Another possible option: \DeclareSIunit ?

]]>