Re: [slf4j-user] SLF4J library using an image
I'd like to thank you all for your feedback and contributions on these illustrations. -- Ceki ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Quite a coincidence that your DNS entry was disabled today. Anyway, thank you for the updated illustration. After placing all stacks on a single line as you have suggested (see [1]), I've integrated the resulting illustration into manual.html. [1] http://goo.gl/Uie0H On 15/08/2011 9:01 PM, Erik van Oosten wrote: Of course this must exactly be the day that no-ip took my DNS entry down (see http://day-to-day-stuff.blogspot.com/2011/08/version-99-dns-off-line.html). Reposted here: http://www.grons.nl/concrete-bindings-eoo.odg http://www.grons.nl/concrete-bindings-eoo.png BTW, I don't care so much for arrows or not. Its just that they are usually not used in this software stacks. Kind regards, Erik. Op 15-08-11 10:15, Erik van Oosten schreef: Hello Ceki, I've added some color and removed the adaption layer from the 'unbound' case. What do you think? http://no-commons-logging.zapto.org/concrete-bindings-eoo.odg http://no-commons-logging.zapto.org/concrete-bindings-eoo.png I think that displaying these stacks horizontally would improve the presentation somewhat more. It emphasizes what a mess you have when you include commons-logging in the mix :) Regards, Erik. -- QOS.ch, main sponsor of cal10n, logback and slf4j open source projects, is looking to hire talented software developers. For further details, see http://logback.qos.ch/job.html ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Of course this must exactly be the day that no-ip took my DNS entry down (see http://day-to-day-stuff.blogspot.com/2011/08/version-99-dns-off-line.html). Reposted here: http://www.grons.nl/concrete-bindings-eoo.odg http://www.grons.nl/concrete-bindings-eoo.png BTW, I don't care so much for arrows or not. Its just that they are usually not used in this software stacks. Kind regards, Erik. Op 15-08-11 10:15, Erik van Oosten schreef: Hello Ceki, I've added some color and removed the adaption layer from the 'unbound' case. What do you think? http://no-commons-logging.zapto.org/concrete-bindings-eoo.odg http://no-commons-logging.zapto.org/concrete-bindings-eoo.png I think that displaying these stacks horizontally would improve the presentation somewhat more. It emphasizes what a mess you have when you include commons-logging in the mix :) Regards, Erik. Op 14-08-11 22:56, Ceki Gülcü schreef: Hi all, I've updated the illustrations taking into account your comments. The updated files are located at: http://slf4j.org/images/concrete-bindings.odg http://slf4j.org/images/concrete-bindings.png http://slf4j.org/images/legacy.odg http://slf4j.org/images/legacy.png The audience for these illustrations are users with little or no prior understanding of or exposure to SLF4J. More concretely, with the help of these illustrations, new users should hopefully stop placing multiple binding artifacts on the class path at the same time. IMO, the arrows convey useful information with respect to direction of invocations albeit perhaps in a stylistically inelegant way. Anyway, your suggestions for further improvements most welcome. In particular regarding the unification of the stacked and arrowed styles (if possible). Cheers, ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user -- Erik van Oosten http://www.day-to-day-stuff.blogspot.com/ ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Hello Ceki, I've added some color and removed the adaption layer from the 'unbound' case. What do you think? http://no-commons-logging.zapto.org/concrete-bindings-eoo.odg http://no-commons-logging.zapto.org/concrete-bindings-eoo.png I think that displaying these stacks horizontally would improve the presentation somewhat more. It emphasizes what a mess you have when you include commons-logging in the mix :) Regards, Erik. Op 14-08-11 22:56, Ceki Gülcü schreef: Hi all, I've updated the illustrations taking into account your comments. The updated files are located at: http://slf4j.org/images/concrete-bindings.odg http://slf4j.org/images/concrete-bindings.png http://slf4j.org/images/legacy.odg http://slf4j.org/images/legacy.png The audience for these illustrations are users with little or no prior understanding of or exposure to SLF4J. More concretely, with the help of these illustrations, new users should hopefully stop placing multiple binding artifacts on the class path at the same time. IMO, the arrows convey useful information with respect to direction of invocations albeit perhaps in a stylistically inelegant way. Anyway, your suggestions for further improvements most welcome. In particular regarding the unification of the stacked and arrowed styles (if possible). Cheers, ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Am 14.08.2011 um 22:56 schrieb Ceki Gülcü: > Hi all, > > I've updated the illustrations taking into account your comments. With the additional description of the arrows in the legend it looks good to me. One more thing which just came to my mind: I would prefer "Adaptation layer" and "Underlying logging framework" boxes in another (slightly different) color in order to visually distinguish the three different layers: API, Adaptation, Underlying logging framework. You could even adjust the different variants in concrete-bindings.png to have all the same vertical hight so that it is visually stressed that for some there is no adaptation layer while for others there is no underlying logging framework layer. Thorsten > The > updated files are located at: > > http://slf4j.org/images/concrete-bindings.odg > http://slf4j.org/images/concrete-bindings.png > > http://slf4j.org/images/legacy.odg > http://slf4j.org/images/legacy.png > > > The audience for these illustrations are users with little or no prior > understanding of or exposure to SLF4J. More concretely, with the help > of these illustrations, new users should hopefully stop placing > multiple binding artifacts on the class path at the same time. > > IMO, the arrows convey useful information with respect to direction of > invocations albeit perhaps in a stylistically inelegant way. > > Anyway, your suggestions for further improvements most welcome. In > particular regarding the unification of the stacked and arrowed styles > (if possible). > > Cheers, > -- > QOS.ch, main sponsor of cal10n, logback and slf4j open source projects, is > looking to hire talented software developers. For further details, see > http://logback.qos.ch/job.html > ___ > slf4j-user mailing list > slf4j-user@qos.ch > http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Looks good. I like the arrows. To reiterate my question about writing a library, in my maven pom.xml for my library, I should only declare a compile/runtime dependency on slf4j-api.jar (that is, no scope, just the groupId, artifactId, and version for slf4j-api), and in my docs explain that if their application is using commons logging that they should also add slf4j-jcl.jar to their classpath/dependencies, or if they're logging directly with log4j then they should add slf4j-log412.jar to their classpath/dependencies, or if they're logging directly with java.util.logging then they should add slf4j-jdk14.jar to their classpath/dependencies? On 2011-08-14 13:56, Ceki Gülcü wrote: Hi all, I've updated the illustrations taking into account your comments. The updated files are located at: http://slf4j.org/images/concrete-bindings.odg http://slf4j.org/images/concrete-bindings.png http://slf4j.org/images/legacy.odg http://slf4j.org/images/legacy.png The audience for these illustrations are users with little or no prior understanding of or exposure to SLF4J. More concretely, with the help of these illustrations, new users should hopefully stop placing multiple binding artifacts on the class path at the same time. IMO, the arrows convey useful information with respect to direction of invocations albeit perhaps in a stylistically inelegant way. Anyway, your suggestions for further improvements most welcome. In particular regarding the unification of the stacked and arrowed styles (if possible). Cheers, ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Hi all, I've updated the illustrations taking into account your comments. The updated files are located at: http://slf4j.org/images/concrete-bindings.odg http://slf4j.org/images/concrete-bindings.png http://slf4j.org/images/legacy.odg http://slf4j.org/images/legacy.png The audience for these illustrations are users with little or no prior understanding of or exposure to SLF4J. More concretely, with the help of these illustrations, new users should hopefully stop placing multiple binding artifacts on the class path at the same time. IMO, the arrows convey useful information with respect to direction of invocations albeit perhaps in a stylistically inelegant way. Anyway, your suggestions for further improvements most welcome. In particular regarding the unification of the stacked and arrowed styles (if possible). Cheers, -- QOS.ch, main sponsor of cal10n, logback and slf4j open source projects, is looking to hire talented software developers. For further details, see http://logback.qos.ch/job.html ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Am 14.08.2011 um 17:33 schrieb Erik van Oosten: > Small correction: the 'original' version is David's (jakartaman). uups, sorry ;-) Thorsten > > For the rest I agree. > > Regards, >Erik. > > > Op 14-08-11 13:35, Thorsten Möller schreef: >> Am 13.08.2011 um 22:17 schrieb jakartaman: >> >>> Now someone needs to take a decision!!11!! >> Well, just my opinion: both make sense to me. Erik's original version >> clearly and tersely describes the (gradual) transition from a logging >> framework other than SLF4J up to the point where just SLF4J backed by >> Logback is used. And I presume depicting this transition was Erik's >> intention. >> >> Ceki's version appeared more comprehensive to me in depicting all the >> combinations in which SLF4J can be deployed. Honestly, however, I was >> interrupted a bit by the arrows since their semantics is not intuitive and >> was also not explained in the legend. To me they are not really necessary >> and I would prefer the typical layered way of depicting it using vertically >> stacked boxes. >> >> To conclude, both are reasonable to the projects documentation, just at >> different places: Erik's could be used for supporting one way (the preferred >> way?) of (gradually) moving from another logging framework to "pure" SLF4J >> logging; Ceki's could be used to support all the different deployment >> combinations. >> >> Thorsten >> >> >> >> >>> :-) >>> >>> On 08/13/2011 10:51 AM, Rusty Wright wrote: I definitely like http://slf4j.org/images/concrete-bindings.png Straightforward and clear. On 2011-08-12 12:32, Ceki Gülcü wrote: > I've taken yet another crack at this: > > http://slf4j.org/images/concrete-bindings.odg > http://slf4j.org/images/concrete-bindings.png > > http://slf4j.org/images/legacy.odg > http://slf4j.org/images/legacy.png > > The idea is to illustrate concrete binding setups using lots of arrows. > :-) > > On 12/08/2011 9:04 AM, Erik van Oosten wrote: >> Hi David, >> >> I liked the clearness of your images as the result of using no arrows >> and different colors for each function. I did have troubles with the >> text, the font size is a tad small for me. >> >> The second image does not show that commons-logging attempts to find a >> logging implementation such as log4j, nor that is specially wired in the >> classpath of many servlet containers. Not sure how to do visualize that >> though. >> >> Regards, >> Erik. > ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user >>> ___ >>> slf4j-user mailing list >>> slf4j-user@qos.ch >>> http://qos.ch/mailman/listinfo/slf4j-user >> ___ >> slf4j-user mailing list >> slf4j-user@qos.ch >> http://qos.ch/mailman/listinfo/slf4j-user > > > -- > Erik van Oosten > http://www.day-to-day-stuff.blogspot.com/ > > ___ > slf4j-user mailing list > slf4j-user@qos.ch > http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Small correction: the 'original' version is David's (jakartaman). For the rest I agree. Regards, Erik. Op 14-08-11 13:35, Thorsten Möller schreef: Am 13.08.2011 um 22:17 schrieb jakartaman: Now someone needs to take a decision!!11!! Well, just my opinion: both make sense to me. Erik's original version clearly and tersely describes the (gradual) transition from a logging framework other than SLF4J up to the point where just SLF4J backed by Logback is used. And I presume depicting this transition was Erik's intention. Ceki's version appeared more comprehensive to me in depicting all the combinations in which SLF4J can be deployed. Honestly, however, I was interrupted a bit by the arrows since their semantics is not intuitive and was also not explained in the legend. To me they are not really necessary and I would prefer the typical layered way of depicting it using vertically stacked boxes. To conclude, both are reasonable to the projects documentation, just at different places: Erik's could be used for supporting one way (the preferred way?) of (gradually) moving from another logging framework to "pure" SLF4J logging; Ceki's could be used to support all the different deployment combinations. Thorsten :-) On 08/13/2011 10:51 AM, Rusty Wright wrote: I definitely like http://slf4j.org/images/concrete-bindings.png Straightforward and clear. On 2011-08-12 12:32, Ceki Gülcü wrote: I've taken yet another crack at this: http://slf4j.org/images/concrete-bindings.odg http://slf4j.org/images/concrete-bindings.png http://slf4j.org/images/legacy.odg http://slf4j.org/images/legacy.png The idea is to illustrate concrete binding setups using lots of arrows. :-) On 12/08/2011 9:04 AM, Erik van Oosten wrote: Hi David, I liked the clearness of your images as the result of using no arrows and different colors for each function. I did have troubles with the text, the font size is a tad small for me. The second image does not show that commons-logging attempts to find a logging implementation such as log4j, nor that is specially wired in the classpath of many servlet containers. Not sure how to do visualize that though. Regards, Erik. ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user -- Erik van Oosten http://www.day-to-day-stuff.blogspot.com/ ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Am 13.08.2011 um 22:17 schrieb jakartaman: > Now someone needs to take a decision!!11!! Well, just my opinion: both make sense to me. Erik's original version clearly and tersely describes the (gradual) transition from a logging framework other than SLF4J up to the point where just SLF4J backed by Logback is used. And I presume depicting this transition was Erik's intention. Ceki's version appeared more comprehensive to me in depicting all the combinations in which SLF4J can be deployed. Honestly, however, I was interrupted a bit by the arrows since their semantics is not intuitive and was also not explained in the legend. To me they are not really necessary and I would prefer the typical layered way of depicting it using vertically stacked boxes. To conclude, both are reasonable to the projects documentation, just at different places: Erik's could be used for supporting one way (the preferred way?) of (gradually) moving from another logging framework to "pure" SLF4J logging; Ceki's could be used to support all the different deployment combinations. Thorsten > > :-) > > On 08/13/2011 10:51 AM, Rusty Wright wrote: >> I definitely like http://slf4j.org/images/concrete-bindings.png >> >> Straightforward and clear. >> >> On 2011-08-12 12:32, Ceki Gülcü wrote: >>> I've taken yet another crack at this: >>> >>> http://slf4j.org/images/concrete-bindings.odg >>> http://slf4j.org/images/concrete-bindings.png >>> >>> http://slf4j.org/images/legacy.odg >>> http://slf4j.org/images/legacy.png >>> >>> The idea is to illustrate concrete binding setups using lots of arrows. :-) >>> >>> On 12/08/2011 9:04 AM, Erik van Oosten wrote: Hi David, I liked the clearness of your images as the result of using no arrows and different colors for each function. I did have troubles with the text, the font size is a tad small for me. The second image does not show that commons-logging attempts to find a logging implementation such as log4j, nor that is specially wired in the classpath of many servlet containers. Not sure how to do visualize that though. Regards, Erik. >>> >>> >> ___ >> slf4j-user mailing list >> slf4j-user@qos.ch >> http://qos.ch/mailman/listinfo/slf4j-user > > ___ > slf4j-user mailing list > slf4j-user@qos.ch > http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Now someone needs to take a decision!!11!! :-) On 08/13/2011 10:51 AM, Rusty Wright wrote: I definitely like http://slf4j.org/images/concrete-bindings.png Straightforward and clear. On 2011-08-12 12:32, Ceki Gülcü wrote: I've taken yet another crack at this: http://slf4j.org/images/concrete-bindings.odg http://slf4j.org/images/concrete-bindings.png http://slf4j.org/images/legacy.odg http://slf4j.org/images/legacy.png The idea is to illustrate concrete binding setups using lots of arrows. :-) On 12/08/2011 9:04 AM, Erik van Oosten wrote: Hi David, I liked the clearness of your images as the result of using no arrows and different colors for each function. I did have troubles with the text, the font size is a tad small for me. The second image does not show that commons-logging attempts to find a logging implementation such as log4j, nor that is specially wired in the classpath of many servlet containers. Not sure how to do visualize that though. Regards, Erik. ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
I definitely like http://slf4j.org/images/concrete-bindings.png Straightforward and clear. On 2011-08-12 12:32, Ceki Gülcü wrote: I've taken yet another crack at this: http://slf4j.org/images/concrete-bindings.odg http://slf4j.org/images/concrete-bindings.png http://slf4j.org/images/legacy.odg http://slf4j.org/images/legacy.png The idea is to illustrate concrete binding setups using lots of arrows. :-) On 12/08/2011 9:04 AM, Erik van Oosten wrote: Hi David, I liked the clearness of your images as the result of using no arrows and different colors for each function. I did have troubles with the text, the font size is a tad small for me. The second image does not show that commons-logging attempts to find a logging implementation such as log4j, nor that is specially wired in the classpath of many servlet containers. Not sure how to do visualize that though. Regards, Erik. ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Ok, thanks. I'm working on a library in my spare time and hadn't thought about this before and this diagram made me think about it. On 2011-08-11 16:27, Ceki Gülcü wrote: Hi Rusty, Letting the end user choose the underlying logging framework is the reason SLF4J exists in the first place. If you specify the actual binding in the pom file of your library, users can no longer choose the logging library which negates SLF4J's purpose. The instructions on dependencies should be part of the SLF4J docs so that authors of libraries can reference them. Such instructions are currently missing. Perhaps that was the point of your post... Cheers, On 12/08/2011 1:14 AM, Rusty Wright wrote: Suppose I'm developing a library that will be used in another person's project and my library uses slf4j. And I don't know what logging framework they use. Should my distribution include slf4j-log412.jar and slf4j-jdk14.jar (or, better, specify both of them as a dependency in my maven pom.xml)? Or should I include instructions that they'll need to download and use either of those jars, depending on which logging framework they're using? Here's what's in my pom.xml at the moment (for logging); the test scope is what keeps the underlying logging framework I'm using (logback) from being a runtime/compile dependency: org.slf4j slf4j-api ${version.slf4j} commons-logging commons-logging 1.1.1 provided commons-logging commons-logging-api 1.1 provided org.slf4j jcl-over-slf4j ${version.slf4j} test org.slf4j log4j-over-slf4j ${version.slf4j} test org.slf4j jul-to-slf4j ${version.slf4j} test ch.qos.logback logback-classic ${version.logback} test On 2011-08-11 13:36, Ceki Gülcü wrote: Hi again, Here is another more comprehensive attempt. It's hard for me to say how much of an improvement these are. Comments welcome. -- Ceki ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
I've taken yet another crack at this: http://slf4j.org/images/concrete-bindings.odg http://slf4j.org/images/concrete-bindings.png http://slf4j.org/images/legacy.odg http://slf4j.org/images/legacy.png The idea is to illustrate concrete binding setups using lots of arrows. :-) On 12/08/2011 9:04 AM, Erik van Oosten wrote: Hi David, I liked the clearness of your images as the result of using no arrows and different colors for each function. I did have troubles with the text, the font size is a tad small for me. The second image does not show that commons-logging attempts to find a logging implementation such as log4j, nor that is specially wired in the classpath of many servlet containers. Not sure how to do visualize that though. Regards, Erik. -- QOS.ch, main sponsor of cal10n, logback and slf4j open source projects, is looking to hire talented software developers. For further details, see http://logback.qos.ch/job.html ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Hi David, I liked the clearness of your images as the result of using no arrows and different colors for each function. I did have troubles with the text, the font size is a tad small for me. The second image does not show that commons-logging attempts to find a logging implementation such as log4j, nor that is specially wired in the classpath of many servlet containers. Not sure how to do visualize that though. Regards, Erik. Op 11-08-11 00:10, jakartaman wrote: Hi Ceki, Here is the new version: http://public.m-plify.neT/SLF4J_intro/SLF4J_intro.odg http://public.m-plify.neT/SLF4J_intro/SLF4J_intro.png http://public.m-plify.neT/SLF4J_intro/SLF4J_intro.tif Best regards, -- David On 08/10/2011 04:22 PM, Ceki Gülcü wrote: On 10/08/2011 4:10 PM, jakartaman wrote: Hi guys, I have finagled a little image to explain the SLF4J library in 10 seconds. Maybe someone wants to recycle it for the the SLF4J documentation page (I don't doubt there are other images though). Have a look: http://public.m-plify.net/SLF4J_intro.png <-- An 1,500px × 523px PNG http://public.m-plify.net/SLF4J_intro.vsd <-- The Microsoft Visio file used to generate the above Best regards, -- David Hi David, I very much like the idea of a graphic better explaining SLF4J. Instead of an abstract logging API such as "X" logging API, I think it would be clearer to present concrete cases as log4j, jul or logback. Would you want to work on this using an open source tool such as Open Office Draw? (I don't own a copy of Visio). -- Ceki ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Hi Rusty, Letting the end user choose the underlying logging framework is the reason SLF4J exists in the first place. If you specify the actual binding in the pom file of your library, users can no longer choose the logging library which negates SLF4J's purpose. The instructions on dependencies should be part of the SLF4J docs so that authors of libraries can reference them. Such instructions are currently missing. Perhaps that was the point of your post... Cheers, On 12/08/2011 1:14 AM, Rusty Wright wrote: Suppose I'm developing a library that will be used in another person's project and my library uses slf4j. And I don't know what logging framework they use. Should my distribution include slf4j-log412.jar and slf4j-jdk14.jar (or, better, specify both of them as a dependency in my maven pom.xml)? Or should I include instructions that they'll need to download and use either of those jars, depending on which logging framework they're using? Here's what's in my pom.xml at the moment (for logging); the test scope is what keeps the underlying logging framework I'm using (logback) from being a runtime/compile dependency: org.slf4j slf4j-api ${version.slf4j} commons-logging commons-logging 1.1.1 provided commons-logging commons-logging-api 1.1 provided org.slf4j jcl-over-slf4j ${version.slf4j} test org.slf4j log4j-over-slf4j ${version.slf4j} test org.slf4j jul-to-slf4j ${version.slf4j} test ch.qos.logback logback-classic ${version.logback} test On 2011-08-11 13:36, Ceki Gülcü wrote: Hi again, Here is another more comprehensive attempt. It's hard for me to say how much of an improvement these are. Comments welcome. -- Ceki -- QOS.ch, main sponsor of cal10n, logback and slf4j open source projects, is looking to hire talented software developers. For further details, see http://logback.qos.ch/job.html ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Suppose I'm developing a library that will be used in another person's project and my library uses slf4j. And I don't know what logging framework they use. Should my distribution include slf4j-log412.jar and slf4j-jdk14.jar (or, better, specify both of them as a dependency in my maven pom.xml)? Or should I include instructions that they'll need to download and use either of those jars, depending on which logging framework they're using? Here's what's in my pom.xml at the moment (for logging); the test scope is what keeps the underlying logging framework I'm using (logback) from being a runtime/compile dependency: org.slf4j slf4j-api ${version.slf4j} commons-logging commons-logging 1.1.1 provided commons-logging commons-logging-api 1.1 provided org.slf4j jcl-over-slf4j ${version.slf4j} test org.slf4j log4j-over-slf4j ${version.slf4j} test org.slf4j jul-to-slf4j ${version.slf4j} test ch.qos.logback logback-classic ${version.logback} test On 2011-08-11 13:36, Ceki Gülcü wrote: Hi again, Here is another more comprehensive attempt. It's hard for me to say how much of an improvement these are. Comments welcome. -- Ceki ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Hi Ceki, Here is the new version: http://public.m-plify.neT/SLF4J_intro/SLF4J_intro.odg http://public.m-plify.neT/SLF4J_intro/SLF4J_intro.png http://public.m-plify.neT/SLF4J_intro/SLF4J_intro.tif Best regards, -- David On 08/10/2011 04:22 PM, Ceki Gülcü wrote: On 10/08/2011 4:10 PM, jakartaman wrote: Hi guys, I have finagled a little image to explain the SLF4J library in 10 seconds. Maybe someone wants to recycle it for the the SLF4J documentation page (I don't doubt there are other images though). Have a look: http://public.m-plify.net/SLF4J_intro.png <-- An 1,500px × 523px PNG http://public.m-plify.net/SLF4J_intro.vsd <-- The Microsoft Visio file used to generate the above Best regards, -- David Hi David, I very much like the idea of a graphic better explaining SLF4J. Instead of an abstract logging API such as "X" logging API, I think it would be clearer to present concrete cases as log4j, jul or logback. Would you want to work on this using an open source tool such as Open Office Draw? (I don't own a copy of Visio). -- Ceki ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Yup, no problem, I will give it a try later today. Hi David, I very much like the idea of a graphic better explaining SLF4J. Instead of an abstract logging API such as "X" logging API, I think it would be clearer to present concrete cases as log4j, jul or logback. Would you want to work on this using an open source tool such as Open Office Draw? (I don't own a copy of Visio). -- Ceki ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
On 10/08/2011 4:10 PM, jakartaman wrote: Hi guys, I have finagled a little image to explain the SLF4J library in 10 seconds. Maybe someone wants to recycle it for the the SLF4J documentation page (I don't doubt there are other images though). Have a look: http://public.m-plify.net/SLF4J_intro.png <-- An 1,500px × 523px PNG http://public.m-plify.net/SLF4J_intro.vsd <-- The Microsoft Visio file used to generate the above Best regards, -- David Hi David, I very much like the idea of a graphic better explaining SLF4J. Instead of an abstract logging API such as "X" logging API, I think it would be clearer to present concrete cases as log4j, jul or logback. Would you want to work on this using an open source tool such as Open Office Draw? (I don't own a copy of Visio). -- Ceki ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
[slf4j-user] SLF4J library using an image
Hi guys, I have finagled a little image to explain the SLF4J library in 10 seconds. Maybe someone wants to recycle it for the the SLF4J documentation page (I don't doubt there are other images though). Have a look: http://public.m-plify.net/SLF4J_intro.png <-- An 1,500px × 523px PNG http://public.m-plify.net/SLF4J_intro.vsd <-- The Microsoft Visio file used to generate the above Best regards, -- David ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user