All of lore.kernel.org
 help / color / mirror / Atom feed
* Re: [Printing-architecture] Required prefixes for symbols in new OP specs
@ 2007-02-07 17:27 McDonald, Ira
  2007-02-07 19:51 ` Michael Sweet
  2007-02-07 23:20 ` Olaf Meeuwissen
  0 siblings, 2 replies; 12+ messages in thread
From: McDonald, Ira @ 2007-02-07 17:27 UTC (permalink / raw)
  To: 'Olaf Meeuwissen'; +Cc: printing-architecture

Hi Olaf,

What prefix (if any) are you currently using for PCM
functions, variables, and constants?

There was a strong concensus at the OP Steering Committee
meeting this Monday that we should NOT use 'fsg' as the
beginning of the prefix for any specs that are not yet 
formally approved.

Relative to Michael Sweet's comment about #define to 
make consistent prefix (e.g., in existing JTAPI C headers),
that may or may not fix problems of linkers - dynamic
linking in Linux appears rather limited relative to some
other platforms - my impression.

Cheers,
- Ira

Ira McDonald (Musician / Software Architect)
Chair - Linux Foundation Open Printing WG
Blue Roof Music / High North Inc
PO Box 221  Grand Marais, MI  49839
phone: +1-906-494-2434
email: imcdonald@sharplabs.com

-----Original Message-----
From: Olaf Meeuwissen [mailto:olaf.meeuwissen@avasys.jp]
Sent: Tuesday, February 06, 2007 7:59 PM
To: McDonald, Ira
Cc: printing-architecture@lists.freestandards.org
Subject: Re: [Printing-architecture] Required prefixes for symbols in
new OP specs


Hi Ira,

"McDonald, Ira" <imcdonald@sharplabs.com> writes:

> Effective immediately, future Open Printing module 
> specs will use prefixes for external identifiers of
> the form:
>
>   "op" + "[mod]" + "_"
>
> where:
>
>   mod == module abbreviation (e.g., "pcm")

I just want to make sure that for PCM we _have_ to use the "oppcm_"
prefix before I convert all the code and docs we are hacking on.

Thanks,
-- 
Olaf Meeuwissen                          EPSON AVASYS Corporation, SE1
FSF Associate Member #1962           sign up at http://member.fsf.org/
GnuPG key: 6BE37D90/AB6B 0D1F 99E7 1BF5 EB97  976A 16C7 F27D 6BE3 7D90
Penguin's lib!       -- I hack, therefore I am --               LPIC-2

-- 
No virus found in this outgoing message.
Checked by AVG Free Edition.
Version: 7.5.432 / Virus Database: 268.17.30/674 - Release Date: 2/7/2007
3:33 PM
 


^ permalink raw reply	[flat|nested] 12+ messages in thread
* Re: [Printing-architecture] Required prefixes for symbols in new OP specs
@ 2007-02-07 17:36 McDonald, Ira
  2007-02-07 23:43 ` Olaf Meeuwissen
  0 siblings, 1 reply; 12+ messages in thread
From: McDonald, Ira @ 2007-02-07 17:36 UTC (permalink / raw)
  To: 'TORATANI Yasumasa'; +Cc: printing-architecture

Hi,

Oops - I hit SEND accidentally a minute ago.

Yes - I like your proposed usage (consistent with
JTAPI C headers).

I agree that a naming standard should go deeper
than just the external function names.

Cheers,
- Ira

Ira McDonald (Musician / Software Architect)
Chair - Linux Foundation Open Printing WG
Blue Roof Music / High North Inc
PO Box 221  Grand Marais, MI  49839
phone: +1-906-494-2434
email: imcdonald@sharplabs.com

-----Original Message-----
From: printing-architecture-bounces@lists.freestandards.org
[mailto:printing-architecture-bounces@lists.freestandards.org]On Behalf
Of TORATANI Yasumasa
Sent: Wednesday, February 07, 2007 12:19 AM
To: McDonald, Ira
Cc: printing-architecture@lists.freestandards.org
Subject: Re: [Printing-architecture] Required prefixes for symbols in
new OP specs


Hi,

I think we should clarify a new naming rule for functions,
enums, typedefs, etc... but we can just convert the former
FSG OpenPrinting naming rule we usually used to use "op"
or "OP" in stead of "fsg" or "FSG".

According to the JTAPI spec, we can re-define the rule as;

Functions:
  "op" + "[mod]" + "[Name]"
  * All "mod" character must be lowercase.
  * "Name" characters can be uppercase or lowercase, but first
     "Name" character must be uppercase.
  example)  opmodOpen( ... );

Enums:
  "OP" + "[MOD]" + "_" + "[NAME]"
  * All alphabetic characters must be uppercase.
  example)  OPMOD_OK

Types:
  "op" + "[mod]" + "_" + "[Name]"
  example)  opmod_return_code_t

Comment?

TORATANI.

On Tue, 6 Feb 2007 09:04:32 -0800 
"McDonald, Ira" <imcdonald@sharplabs.com> wrote:

> Hi,
> 
> Per our discussion at yesterday's Linux Foundation
> Open Printing Steering Committee teleconference.
> 
> Effective immediately, future Open Printing module 
> specs will use prefixes for external identifiers of
> the form:
> 
>   "op" + "[mod]" + "_"
> 
> where:
> 
>   mod == module abbreviation (e.g., "pcm")
> 
> instead of the previous "fsg" + "[mod]" + "_" (e.g.,
> "fsgjt_" in OP Job Ticket API).  But, we will NEVER
> change the "fsgxx_" prefix in adopted and published
> OP specs (for stability and backwards compatibility).
> 
> This change in standard OP prefixes will hopefully
> future-proof our APIs against future organizational
> changes and renames (e.g., FSG --> Linux Foundation).
> 
> Cheers,
> - Ira
> 
> 
> Ira McDonald (Musician / Software Architect)
> Chair - Linux Foundation Open Printing WG
> Blue Roof Music / High North Inc
> PO Box 221  Grand Marais, MI  49839
> phone: +1-906-494-2434
> email: imcdonald@sharplabs.com
> 
> -- 
> No virus found in this outgoing message.
> Checked by AVG Free Edition.
> Version: 7.5.432 / Virus Database: 268.17.28/672 - Release Date: 2/6/2007
> 10:22 AM
>  
> 
> _______________________________________________
> Printing-architecture mailing list
> Printing-architecture@lists.freestandards.org
> http://lists.freestandards.org/mailman/listinfo/printing-architecture

-----------------------------------------
TORATANI Yasumasa
Software Engineering Dept.23
Platform Technology Development Headquarters, CANON INC.

_______________________________________________
Printing-architecture mailing list
Printing-architecture@lists.freestandards.org
http://lists.freestandards.org/mailman/listinfo/printing-architecture

-- 
No virus found in this outgoing message.
Checked by AVG Free Edition.
Version: 7.5.432 / Virus Database: 268.17.30/674 - Release Date: 2/7/2007
3:33 PM
 


^ permalink raw reply	[flat|nested] 12+ messages in thread
* Re: [Printing-architecture] Required prefixes for symbols in new OP specs
@ 2007-02-07 17:33 McDonald, Ira
  0 siblings, 0 replies; 12+ messages in thread
From: McDonald, Ira @ 2007-02-07 17:33 UTC (permalink / raw)
  To: 'TORATANI Yasumasa'; +Cc: printing-architecture



Ira McDonald (Musician / Software Architect)
Chair - Linux Foundation Open Printing WG
Blue Roof Music / High North Inc
PO Box 221  Grand Marais, MI  49839
phone: +1-906-494-2434
email: imcdonald@sharplabs.com

-----Original Message-----
From: printing-architecture-bounces@lists.freestandards.org
[mailto:printing-architecture-bounces@lists.freestandards.org]On Behalf
Of TORATANI Yasumasa
Sent: Wednesday, February 07, 2007 12:19 AM
To: McDonald, Ira
Cc: printing-architecture@lists.freestandards.org
Subject: Re: [Printing-architecture] Required prefixes for symbols in
new OP specs


Hi,

I think we should clarify a new naming rule for functions,
enums, typedefs, etc... but we can just convert the former
FSG OpenPrinting naming rule we usually used to use "op"
or "OP" in stead of "fsg" or "FSG".

According to the JTAPI spec, we can re-define the rule as;

Functions:
  "op" + "[mod]" + "[Name]"
  * All "mod" character must be lowercase.
  * "Name" characters can be uppercase or lowercase, but first
     "Name" character must be uppercase.
  example)  opmodOpen( ... );

Enums:
  "OP" + "[MOD]" + "_" + "[NAME]"
  * All alphabetic characters must be uppercase.
  example)  OPMOD_OK

Types:
  "op" + "[mod]" + "_" + "[Name]"
  example)  opmod_return_code_t

Comment?

TORATANI.

On Tue, 6 Feb 2007 09:04:32 -0800 
"McDonald, Ira" <imcdonald@sharplabs.com> wrote:

> Hi,
> 
> Per our discussion at yesterday's Linux Foundation
> Open Printing Steering Committee teleconference.
> 
> Effective immediately, future Open Printing module 
> specs will use prefixes for external identifiers of
> the form:
> 
>   "op" + "[mod]" + "_"
> 
> where:
> 
>   mod == module abbreviation (e.g., "pcm")
> 
> instead of the previous "fsg" + "[mod]" + "_" (e.g.,
> "fsgjt_" in OP Job Ticket API).  But, we will NEVER
> change the "fsgxx_" prefix in adopted and published
> OP specs (for stability and backwards compatibility).
> 
> This change in standard OP prefixes will hopefully
> future-proof our APIs against future organizational
> changes and renames (e.g., FSG --> Linux Foundation).
> 
> Cheers,
> - Ira
> 
> 
> Ira McDonald (Musician / Software Architect)
> Chair - Linux Foundation Open Printing WG
> Blue Roof Music / High North Inc
> PO Box 221  Grand Marais, MI  49839
> phone: +1-906-494-2434
> email: imcdonald@sharplabs.com
> 
> -- 
> No virus found in this outgoing message.
> Checked by AVG Free Edition.
> Version: 7.5.432 / Virus Database: 268.17.28/672 - Release Date: 2/6/2007
> 10:22 AM
>  
> 
> _______________________________________________
> Printing-architecture mailing list
> Printing-architecture@lists.freestandards.org
> http://lists.freestandards.org/mailman/listinfo/printing-architecture

-----------------------------------------
TORATANI Yasumasa
Software Engineering Dept.23
Platform Technology Development Headquarters, CANON INC.

_______________________________________________
Printing-architecture mailing list
Printing-architecture@lists.freestandards.org
http://lists.freestandards.org/mailman/listinfo/printing-architecture

-- 
No virus found in this outgoing message.
Checked by AVG Free Edition.
Version: 7.5.432 / Virus Database: 268.17.30/674 - Release Date: 2/7/2007
3:33 PM
 


^ permalink raw reply	[flat|nested] 12+ messages in thread
* [Printing-architecture] Required prefixes for symbols in new OP specs
@ 2007-02-06 17:04 McDonald, Ira
  2007-02-07  0:59 ` Olaf Meeuwissen
  2007-02-07  5:19 ` TORATANI Yasumasa
  0 siblings, 2 replies; 12+ messages in thread
From: McDonald, Ira @ 2007-02-06 17:04 UTC (permalink / raw)
  To: printing-architecture

Hi,

Per our discussion at yesterday's Linux Foundation
Open Printing Steering Committee teleconference.

Effective immediately, future Open Printing module 
specs will use prefixes for external identifiers of
the form:

  "op" + "[mod]" + "_"

where:

  mod == module abbreviation (e.g., "pcm")

instead of the previous "fsg" + "[mod]" + "_" (e.g.,
"fsgjt_" in OP Job Ticket API).  But, we will NEVER
change the "fsgxx_" prefix in adopted and published
OP specs (for stability and backwards compatibility).

This change in standard OP prefixes will hopefully
future-proof our APIs against future organizational
changes and renames (e.g., FSG --> Linux Foundation).

Cheers,
- Ira


Ira McDonald (Musician / Software Architect)
Chair - Linux Foundation Open Printing WG
Blue Roof Music / High North Inc
PO Box 221  Grand Marais, MI  49839
phone: +1-906-494-2434
email: imcdonald@sharplabs.com

-- 
No virus found in this outgoing message.
Checked by AVG Free Edition.
Version: 7.5.432 / Virus Database: 268.17.28/672 - Release Date: 2/6/2007
10:22 AM
 


^ permalink raw reply	[flat|nested] 12+ messages in thread

end of thread, other threads:[~2007-02-08  3:16 UTC | newest]

Thread overview: 12+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2007-02-07 17:27 [Printing-architecture] Required prefixes for symbols in new OP specs McDonald, Ira
2007-02-07 19:51 ` Michael Sweet
2007-02-08  3:01   ` Norm Jacobs
2007-02-08  3:16     ` Michael Sweet
2007-02-07 23:20 ` Olaf Meeuwissen
  -- strict thread matches above, loose matches on Subject: below --
2007-02-07 17:36 McDonald, Ira
2007-02-07 23:43 ` Olaf Meeuwissen
2007-02-08  0:07   ` TORATANI Yasumasa
2007-02-07 17:33 McDonald, Ira
2007-02-06 17:04 McDonald, Ira
2007-02-07  0:59 ` Olaf Meeuwissen
2007-02-07  5:19 ` TORATANI Yasumasa

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.